docs: clarify login url usage (vercel#9963)

### Description Clarifying that you don't need the login configurations, flags, environment variables, etc. unless you're building a server-side solution that can dynamically generate tokens. ### Testing Instructions 👀
joshnuss · Feb 15, 2025 · 1940ae7 · 1940ae7
1 parent e262569
commit 1940ae7
Show file tree

Hide file tree

Showing 3 changed files with 13 additions and 4 deletions.
diff --git a/docs/repo-docs/reference/link.mdx b/docs/repo-docs/reference/link.mdx
@@ -13,14 +13,22 @@ The selected owner (either a user or an organization) will be able to share [cac
 
 Specifies the URL of your Remote Cache provider.
 
+```bash title="Terminal"
+turbo link --api=https://example.com
+```
+
 ### `--yes`
 
 Answer yes to all prompts
 
+```bash title="Terminal"
+turbo link --yes
+```
+
 ### `--scope <scope>`
 
-The scope, i.e. Vercel team, to which you are linking
+The scope to which you are linking. For example, when using Vercel, this is your Vercel team's slug.
 
 ```bash title="Terminal"
-turbo link --api https://acme.com
+turbo link --scope=your-team
 ```
diff --git a/docs/repo-docs/reference/login.mdx b/docs/repo-docs/reference/login.mdx
@@ -19,7 +19,7 @@ turbo login --api=https://acme.com/api
 
 ### --login \<url>
 
-Set the URL for login requests. This is only required for platforms with robust login features.
+Set the URL for login requests that should dynamically generate tokens.
 
 ```bash title="Terminal"
 turbo login --login=https://acme.com

diff --git a/docs/repo-docs/reference/system-environment-variables.mdx b/docs/repo-docs/reference/system-environment-variables.mdx
@@ -144,7 +144,8 @@ System environment variables are always overridden by flag values provided direc
       </td>
       <td>
         Set the URL used to log in to{' '}
-        <a href="/repo/docs/core-concepts/remote-caching">Remote Cache</a>.
+        <a href="/repo/docs/core-concepts/remote-caching">Remote Cache</a>. Only
+        needed for self-hosted Remote Caches that implement an endpoint that dynamically creates tokens.
       </td>
     </tr>
     <tr id="turbo_no_update_notifier">