diff --git a/README.md b/README.md
index 9a32e9a..4f4670e 100644
--- a/README.md
+++ b/README.md
@@ -251,6 +251,8 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 
 ## Checkout multiple repos (nested)
 
+Note: the checkout order must be primary _then_ secondary repo checkout.
+
 ```yaml
 - name: Checkout
   uses: actions/checkout@v5
@@ -265,6 +267,8 @@ Please refer to the [release page](https://github.com/actions/checkout/releases/
 
 ## Checkout multiple repos (private)
 
+Note: the checkout order must be primary _then_ secondary repo checkout.
+
 ```yaml
 - name: Checkout
   uses: actions/checkout@v5