docs: widen sidebar + fix Claude Code install method + clarify MCP verification#106
Merged
Conversation
…fication - docs sidebar: override Starlight --sl-sidebar-width 18.75rem -> 19.75rem (single source of truth; --sl-content-width is independent, print stylesheet keeps its own 0px override). - ai-assisted-development/agents/claude-code.md: replace the deprecated `npm install -g @anthropic-ai/claude-code` + nonexistent `claude auth login` with the current native installer (`curl -fsSL https://claude.ai/install.sh | bash`) and first-run browser login / `/login`; expand the two .claude/settings.json keys (extraKnownMarketplaces.marko, enabledPlugins) with what each does and how Claude Code consumes them on folder-trust. - verification-checklist.md: Claude Code MCP is provided by the marko-mcp@marko plugin, not `claude mcp add` — verify via .claude/settings.json + `/mcp`, not `claude mcp list`. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Small docs/CSS follow-ups after the
marko/devailanding.Changes
Sidebar width —
docs/src/styles/custom.cssoverrides Starlight's--sl-sidebar-widthfrom the default18.75remto19.75rem. Starlight derives the whole layout from this single variable (--sl-content-widthis independent, and the print stylesheet keeps its own0pxoverride), so no other change is needed.Claude Code install method —
ai-assisted-development/agents/claude-code.mdwas telling users to install vianpm install -g @anthropic-ai/claude-codeand authenticate withclaude auth login. Both are stale:curl -fsSL https://claude.ai/install.sh | bash(npm still works but is no longer preferred; the native install auto-updates). Source: Claude Code setup docs.claude auth logincommand — first run opens a browser sign-in;/loginmanages credentials in-session.claude doctorverifies the install..claude/settings.jsonexplanation — expanded the two key bullets (extraKnownMarketplaces.marko,enabledPlugins) with what each key is, the local-vs-GitHubsourceshapes, and how Claude Code consumes them on folder-trust (and that devai only touches*@markoentries).Verification checklist — Claude Code's MCP server comes from the
marko-mcp@markoplugin, notclaude mcp add(the agent actively removes legacyclaude mcpregistrations). Changed the check fromclaude mcp listto.claude/settings.json+/mcp.Verification
cd docs && npm run build→ 140 pages, clean.composer test(docs-markdown) → 12 passed.