diff --git a/README.md b/README.md
index 7e76cde..eafe5a0 100644
--- a/README.md
+++ b/README.md
@@ -208,6 +208,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@v4
@@ -222,6 +224,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@v4