fix(docs): handle symlinked file in lychee link checker

This restores absolute root-relative paths in CONTRIBUTING.md and README.md, and adds them to .lycheeignore. Because CONTRIBUTING.md is symlinked in docs/, relative paths resolve incorrectly during link checking but work on GitHub. Ignoring them prevents the false positive link check failures.

.lycheeignore

@@ -4,3 +4,6 @@ https://github.com/google-gemini/maintainers-gemini-cli/blob/main/npm.md
 https://github.com/settings/personal-access-tokens/new
 https://github.com/settings/tokens/new
 https://www.npmjs.com/package/@google/gemini-cli
+/docs/assets/connected_devtools.png
+/docs/sidebar.json
+/docs/assets/gemini-screenshot.png

CONTRIBUTING.md

@@ -557,7 +557,7 @@ Before submitting your documentation pull request, please:
 
 If you have questions about contributing documentation:
 
-- Check our [FAQ](https://geminicli.com/docs/resources/faq).
+- Check our [FAQ](https://geminicli.com/docs/faq).
 - Review existing documentation for examples.
 - Open [an issue](https://github.com/google-gemini/gemini-cli/issues) to discuss
   your proposed changes.

README.md

@@ -382,7 +382,7 @@ instructions.
 ## 📄 Legal
 
 - **License**: [Apache License 2.0](LICENSE)
-- **Terms of Service**: [Terms & Privacy](./docs/resources/tos-privacy.md)
+- **Terms of Service**: [Terms & Privacy](./docs/tos-privacy)
 - **Security**: [Security Policy](SECURITY.md)
 
 ---

docs/cli/telemetry.md

@@ -187,11 +187,11 @@ visualize your telemetry.
 Find this dashboard under **Google Cloud Monitoring Dashboard Templates** as
 "**Gemini CLI Monitoring**".
 
-![Gemini CLI Monitoring Dashboard Overview](/docs/assets/monitoring-dashboard-overview.png)
+![Gemini CLI Monitoring Dashboard Overview](../assets/monitoring-dashboard-overview.png)
 
-![Gemini CLI Monitoring Dashboard Metrics](/docs/assets/monitoring-dashboard-metrics.png)
+![Gemini CLI Monitoring Dashboard Metrics](../assets/monitoring-dashboard-metrics.png)
 
-![Gemini CLI Monitoring Dashboard Logs](/docs/assets/monitoring-dashboard-logs.png)
+![Gemini CLI Monitoring Dashboard Logs](../assets/monitoring-dashboard-logs.png)
 
 To learn more, see
 [Instant insights: Gemini CLI’s pre-configured monitoring dashboards](https://cloud.google.com/blog/topics/developers-practitioners/instant-insights-gemini-clis-new-pre-configured-monitoring-dashboards/).

docs/get-started/authentication.md

@@ -403,4 +403,4 @@ Your authentication method affects your quotas, pricing, Terms of Service, and
 privacy notices. Review the following pages to learn more:
 
 - [Gemini CLI: Quotas and Pricing](../resources/quota-and-pricing.md).
-- [Gemini CLI: Terms of Service and Privacy Notice](../resources/tos-privacy.md).
+- [Gemini CLI: Terms of Service and Privacy Notice](../resources/tos-privacy).

docs/index.md

@@ -126,7 +126,7 @@ Support, release history, and legal information.
 
 ## Development
 
-- **[Contribution guide](/docs/contributing):** How to contribute to Gemini CLI.
+- **[Contribution guide](../CONTRIBUTING.md):** How to contribute to Gemini CLI.
 - **[Integration testing](./integration-tests.md):** Running integration tests.
 - **[Issue and PR automation](./issue-and-pr-automation.md):** Automation for
   issues and pull requests.

packages/cli/src/config/config.ts

@@ -214,7 +214,7 @@ export async function parseArguments(
           string: true,
           nargs: 1,
           description:
-            '[DEPRECATED: Use Policy Engine instead See https://geminicli.com/docs/core/policy-engine] Tools that are allowed to run without confirmation',
+            '[DEPRECATED: Use Policy Engine instead See https://geminicli.com/docs/policy-engine] Tools that are allowed to run without confirmation',
           coerce: coerceCommaSeparated,
         })
         .option('extensions', {

packages/cli/src/config/settings-validation.test.ts

@@ -323,9 +323,7 @@ describe('settings-validation', () => {
         expect(formatted).toContain('model.name');
         expect(formatted).toContain('Expected: string, but received: object');
         expect(formatted).toContain('Please fix the configuration.');
-        expect(formatted).toContain(
-          'https://geminicli.com/docs/reference/configuration/',
-        );
+        expect(formatted).toContain('https://geminicli.com/docs/configuration');
       }
     });
 
@@ -363,9 +361,7 @@ describe('settings-validation', () => {
       if (result.error) {
         const formatted = formatValidationError(result.error, 'test.json');
 
-        expect(formatted).toContain(
-          'https://geminicli.com/docs/reference/configuration/',
-        );
+        expect(formatted).toContain('https://geminicli.com/docs/configuration');
       }
     });
 

packages/cli/src/config/settings-validation.ts

@@ -327,7 +327,7 @@ export function formatValidationError(
   }
 
   lines.push('Please fix the configuration.');
-  lines.push('See: https://geminicli.com/docs/reference/configuration/');
+  lines.push('See: https://geminicli.com/docs/configuration');
 
   return lines.join('\n');
 }

packages/cli/src/gemini.tsx

@@ -239,7 +239,7 @@ export async function main() {
   ) {
     coreEvents.emitFeedback(
       'warning',
-      'Warning: --allowed-tools cli argument and tools.allowed in settings.json are deprecated and will be removed in 1.0: Migrate to Policy Engine: https://geminicli.com/docs/core/policy-engine/',
+      'Warning: --allowed-tools cli argument and tools.allowed in settings.json are deprecated and will be removed in 1.0: Migrate to Policy Engine: https://geminicli.com/docs/policy-engine',
     );
   }
 
@@ -249,7 +249,7 @@ export async function main() {
   ) {
     coreEvents.emitFeedback(
       'warning',
-      'Warning: tools.exclude in settings.json is deprecated and will be removed in 1.0. Migrate to Policy Engine: https://geminicli.com/docs/core/policy-engine/',
+      'Warning: tools.exclude in settings.json is deprecated and will be removed in 1.0. Migrate to Policy Engine: https://geminicli.com/docs/policy-engine',
     );
   }
 

packages/cli/src/ui/auth/AuthDialog.tsx

@@ -246,7 +246,7 @@ export function AuthDialog({
         </Box>
         <Box marginTop={1}>
           <Text color={theme.text.link}>
-            {'https://geminicli.com/docs/resources/tos-privacy/'}
+            {'https://geminicli.com/docs/tos-privacy'}
           </Text>
         </Box>
       </Box>

packages/cli/src/ui/auth/__snapshots__/AuthDialog.test.tsx.snap

@@ -15,7 +15,7 @@ exports[`AuthDialog > Snapshots > renders correctly with auth error 1`] = `
 │                                                                                                  │
 │   Terms of Services and Privacy Notice for Gemini CLI                                            │
 │                                                                                                  │
-│   https://geminicli.com/docs/resources/tos-privacy/                                              │
+│   https://geminicli.com/docs/tos-privacy                                                         │
 │                                                                                                  │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 "
@@ -34,7 +34,7 @@ exports[`AuthDialog > Snapshots > renders correctly with default props 1`] = `
 │                                                                                                  │
 │   Terms of Services and Privacy Notice for Gemini CLI                                            │
 │                                                                                                  │
-│   https://geminicli.com/docs/resources/tos-privacy/                                              │
+│   https://geminicli.com/docs/tos-privacy                                                         │
 │                                                                                                  │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 "
@@ -53,7 +53,7 @@ exports[`AuthDialog > Snapshots > renders correctly with enforced auth type 1`]
 │                                                                                                  │
 │   Terms of Services and Privacy Notice for Gemini CLI                                            │
 │                                                                                                  │
-│   https://geminicli.com/docs/resources/tos-privacy/                                              │
+│   https://geminicli.com/docs/tos-privacy                                                         │
 │                                                                                                  │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 "

packages/cli/src/ui/constants.ts

@@ -41,7 +41,7 @@ export const DEFAULT_SELECTION_OPACITY = 0.2;
 export const DEFAULT_BORDER_OPACITY = 0.4;
 
 export const KEYBOARD_SHORTCUTS_URL =
-  'https://geminicli.com/docs/cli/keyboard-shortcuts/';
+  'https://geminicli.com/docs/keyboard-shortcuts';
 export const LRU_BUFFER_PERF_CACHE_LIMIT = 20000;
 
 // Max lines to show for active shell output when not focused

packages/vscode-ide-companion/README.md

@@ -31,4 +31,4 @@ To use this extension, you'll need:
 # Terms of Service and Privacy Notice
 
 By installing this extension, you agree to the
-[Terms of Service](https://geminicli.com/docs/resources/tos-privacy/).
+[Terms of Service](https://geminicli.com/docs/tos-privacy).