docs: replace '.. rest of config ..' with explicit repo selection fields in auth examples (#982)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: brendan-kellam

docs/docs/connections/ado-cloud.mdx

@@ -100,8 +100,11 @@ Next, provide the access [token](/docs/configuration/config-file#tokens) via an
                 // note: this env var can be named anything. It
                 // doesn't need to be `ADO_TOKEN`.
                 "env": "ADO_TOKEN"
-            }
-            // .. rest of config ..
+            },
+            // At least one of the following is required to specify which repos to sync:
+            "repos": ["organizationName/projectName/repoName"],
+            // "orgs": ["organizationName"],
+            // "projects": ["organizationName/projectName"]
         }
         ```
 

docs/docs/connections/ado-server.mdx

@@ -114,8 +114,11 @@ Next, provide the access [token](/docs/configuration/config-file#tokens) via an
                 // note: this env var can be named anything. It
                 // doesn't need to be `ADO_TOKEN`.
                 "env": "ADO_TOKEN"
-            }
-            // .. rest of config ..
+            },
+            // At least one of the following is required to specify which repos to sync:
+            "repos": ["collectionName/projectName/repoName"],
+            // "orgs": ["collectionName"],
+            // "projects": ["collectionName/projectName"]
         }
         ```
 

docs/docs/connections/bitbucket-cloud.mdx

@@ -102,8 +102,11 @@ In order to index private repositories, you'll need to provide authentication cr
               // note: this env var can be named anything. It
               // doesn't need to be `BITBUCKET_TOKEN`.
               "env": "BITBUCKET_TOKEN"
-          }
-          // .. rest of config ..
+          },
+          // At least one of the following is required to specify which repos to sync:
+          "repos": ["myWorkspace/myRepo"],
+          // "workspaces": ["myWorkspace"],
+          // "projects": ["myProject"]
       }
       ```
 
@@ -130,8 +133,11 @@ In order to index private repositories, you'll need to provide authentication cr
               // note: this env var can be named anything. It
               // doesn't need to be `BITBUCKET_TOKEN`.
               "env": "BITBUCKET_TOKEN"
-          }
-          // .. rest of config ..
+          },
+          // At least one of the following is required to specify which repos to sync:
+          "repos": ["myWorkspace/myRepo"],
+          // "workspaces": ["myWorkspace"],
+          // "projects": ["myProject"]
       }
       ```
 
@@ -164,8 +170,11 @@ In order to index private repositories, you'll need to provide authentication cr
               // note: this env var can be named anything. It
               // doesn't need to be `BITBUCKET_TOKEN`.
               "env": "BITBUCKET_TOKEN"
-          }
-          // .. rest of config ..
+          },
+          // At least one of the following is required to specify which repos to sync:
+          "repos": ["myWorkspace/myRepo"],
+          // "workspaces": ["myWorkspace"],
+          // "projects": ["myProject"]
       }
       ```
 

docs/docs/connections/bitbucket-data-center.mdx

@@ -104,8 +104,11 @@ In order to index private repositories, you'll need to provide a [HTTP Access To
                 // note: this env var can be named anything. It
                 // doesn't need to be `BITBUCKET_TOKEN`.
                 "env": "BITBUCKET_TOKEN"
-            }
-            // .. rest of config ..
+            },
+            // At least one of the following is required to specify which repos to sync:
+            "repos": ["myProject/myRepo"],
+            // "projects": ["myProject"],
+            // "all": true
         }
         ```
 
@@ -134,8 +137,11 @@ In order to index private repositories, you'll need to provide a [HTTP Access To
                 // note: this env var can be named anything. It
                 // doesn't need to be `BITBUCKET_TOKEN`.
                 "env": "BITBUCKET_TOKEN"
-            }
-            // .. rest of config ..
+            },
+            // At least one of the following is required to specify which repos to sync:
+            "repos": ["myProject/myRepo"],
+            // "projects": ["myProject"],
+            // "all": true
         }
         ```
 

docs/docs/connections/gerrit.mdx

@@ -19,8 +19,9 @@ To connect to a gerrit instance, provide the `url` property to your config:
 ```json
 {
     "type": "gerrit",
-    "url": "https://gerrit.example.com"
-    // .. rest of config ..
+    "url": "https://gerrit.example.com",
+    // Specify which projects to sync using glob patterns:
+    "projects": ["project1/**"]
 }
 ```
 

docs/docs/connections/gitea.mdx

@@ -94,8 +94,11 @@ Next, provide the access token via an environment variable [token](/docs/configu
                 // note: this env var can be named anything. It
                 // doesn't need to be `GITEA_TOKEN`.
                 "env": "GITEA_TOKEN"
-            }
-            // .. rest of config ..
+            },
+            // At least one of the following is required to specify which repos to sync:
+            "repos": ["my-org/myRepo"],
+            // "orgs": ["my-org"],
+            // "users": ["my-user"]
         }
         ```
 
@@ -116,8 +119,11 @@ To connect to a custom Gitea deployment, provide the `url` property to your conf
 ```json
 {
     "type": "gitea",
-    "url": "https://gitea.example.com"
-    // .. rest of config ..
+    "url": "https://gitea.example.com",
+    // At least one of the following is required to specify which repos to sync:
+    "repos": ["my-org/myRepo"],
+    // "orgs": ["my-org"],
+    // "users": ["my-user"]
 }
 ```
 

docs/docs/connections/github.mdx

@@ -172,8 +172,11 @@ In order to index private repositories, you'll need to authenticate with GitHub.
                             // note: this env var can be named anything. It
                             // doesn't need to be `GITHUB_TOKEN`.
                             "env": "GITHUB_TOKEN"
-                        }
-                        // .. rest of config ..
+                        },
+                        // At least one of the following is required to specify which repos to sync:
+                        "repos": ["my-org/myRepo"],
+                        // "orgs": ["my-org"],
+                        // "users": ["my-user"]
                     }
                     ```
             </Step>
@@ -203,8 +206,11 @@ In order to index private repositories, you'll need to authenticate with GitHub.
                             // note: this env var can be named anything. It
                             // doesn't need to be `GITHUB_TOKEN`.
                             "env": "GITHUB_TOKEN"
-                        }
-                        // .. rest of config ..
+                        },
+                        // At least one of the following is required to specify which repos to sync:
+                        "repos": ["my-org/myRepo"],
+                        // "orgs": ["my-org"],
+                        // "users": ["my-user"]
                     }
                     ```
             </Step>
@@ -222,8 +228,11 @@ To connect to a GitHub host other than `github.com`, provide the `url` property
 ```json
 {
     "type": "github",
-    "url": "https://github.example.com"
-    // .. rest of config ..
+    "url": "https://github.example.com",
+    // At least one of the following is required to specify which repos to sync:
+    "repos": ["my-org/myRepo"],
+    // "orgs": ["my-org"],
+    // "users": ["my-user"]
 }
 ```
 

docs/docs/connections/gitlab.mdx

@@ -129,8 +129,12 @@ Next, provide the PAT via an environment variable [token](/docs/configuration/co
                 // note: this env var can be named anything. It
                 // doesn't need to be `GITLAB_TOKEN`.
                 "env": "GITLAB_TOKEN"
-            }
-            // .. rest of config ..
+            },
+            // At least one of the following is required to specify which projects to sync:
+            "projects": ["my-group/myProject"],
+            // "groups": ["my-group"],
+            // "users": ["my-user"],
+            // "all": true (self-managed only)
         }
         ```
 
@@ -151,8 +155,12 @@ To connect to a GitLab host other than `gitlab.com`, provide the `url` property
 ```json
 {
     "type": "gitlab",
-    "url": "https://gitlab.example.com"
-    // .. rest of config ..
+    "url": "https://gitlab.example.com",
+    // At least one of the following is required to specify which projects to sync:
+    "projects": ["my-group/myProject"],
+    // "groups": ["my-group"],
+    // "users": ["my-user"],
+    // "all": true
 }
 ```