Issue Station
Sign In
Tools hereToolbox

gemini-cli - ✅(Solved) Fix (docs) Update pages to use tabbed components [1 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
google-gemini/gemini-cli#24957•Fetched 2026-04-09 08:16:50
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Author
g-samrobertsg-samroberts
Participants
g-samrobertsg-samroberts
Assignees
g-samrobertsg-samroberts
Timeline (top)
labeled ×3assigned ×1unlabeled ×1

PR fix notes

PR #25155: docs: migrate installation and authentication to mdx with tabbed layouts

Description (problem / solution / changelog)

Summary

Migrates the installation.md and authentication.md files to the .mdx format to leverage dynamic components.

Details

  • installation.mdx: Added tabs for Installation methods, Advanced Run methods, and Release channels.
  • authentication.mdx: Added tabs for macOS/Linux vs Windows (PowerShell) code blocks throughout the document.
  • Updated all relative cross-links in the docs/ directory to point to the new .mdx extensions.
  • Updated docs-writer skill instructions to reflect the difference in Prettier ignore comment syntax between .md (<!-- prettier-ignore -->) and .mdx ({/* prettier-ignore */}).

Related Issues

Fixes #24957

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Docker
      • Podman
      • Seatbelt
    • Windows
      • npm run
      • npx
      • Docker
    • Linux
      • npm run
      • npx
      • Docker

Changed files

  • .gemini/skills/docs-writer/SKILL.md (modified, +15/-6)
  • .prettierignore (modified, +1/-0)
  • docs/cli/enterprise.md (modified, +1/-1)
  • docs/cli/system-prompt.md (modified, +1/-1)
  • docs/get-started/authentication.mdx (renamed, +139/-93)
  • docs/get-started/index.md (modified, +3/-2)
  • docs/get-started/installation.md (removed, +0/-181)
  • docs/get-started/installation.mdx (added, +201/-0)
  • docs/index.md (modified, +2/-2)
  • docs/reference/configuration.md (modified, +2/-2)
RAW_BUFFERClick to expand / collapse

URL of the page with the issue

https://geminicli.com/docs/get-started/installation/

What is the problem?

Audit the documentation and identify pages that have multiple ways of doing the same thing, for example, different commands on different OS's to install Gemini CLI. Update these pages to be .mdx files that use the tabbed widget component.

What did you expect to happen?

Pages are currently difficult to read as different methods to accomplish the same thing are presented serially.

Additional context

Example: Installation methods on https://geminicli.com/docs/get-started/installation/

extent analysis

TL;DR

Update the installation documentation page to use .mdx files with a tabbed widget component to simplify multiple installation methods.

Guidance

  • Identify pages with multiple methods for the same task, such as the installation page, and prioritize them for update.
  • Convert these pages to .mdx files to utilize the tabbed widget component for better organization.
  • Review the tabbed widget component documentation to ensure correct implementation and usage.
  • Test the updated pages for readability and usability improvements.

Example

No code snippet is provided as the issue focuses on documentation updates rather than code changes.

Notes

The solution assumes that the tabbed widget component is already available and documented. If not, additional development or research may be required to implement this component.

Recommendation

Apply workaround: Update the documentation pages to use .mdx files with the tabbed widget component to improve readability and user experience. This approach addresses the immediate issue of complex documentation without requiring significant code changes.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#installation#cache issue#memory leak#API versioning#request timeout

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING