diff --git a/README.md b/README.md
index ddfc7ee..3170258 100644
--- a/README.md
+++ b/README.md
@@ -158,6 +158,8 @@ When Git 2.18 or higher is not in your PATH, falls back to the REST API to downl
 
 ## Checkout multiple repos (nested)
 
+Note: the checkout order must be primary _then_ secondary repo checkout.
+
 ```yaml
 - name: Checkout
   uses: actions/checkout@v3
@@ -171,6 +173,8 @@ When Git 2.18 or higher is not in your PATH, falls back to the REST API to downl
 
 ## Checkout multiple repos (private)
 
+Note: the checkout order must be primary _then_ secondary repo checkout.
+
 ```yaml
 - name: Checkout
   uses: actions/checkout@v3