Skip to content

Conversation

@masnwilliams
Copy link
Contributor

@masnwilliams masnwilliams commented Sep 1, 2025

Description

Please provide an explanation of the changes you've made:

[Describe what this PR does and why]

Implementation Checklist

  • If updating our sample apps, update the info in our Quickstart
  • If updating our CLI, update the info in our CLI

Testing

  • mintlify dev works (see installation here)

Docs

  • Link to a PR in our docs repo documenting your change (if applicable)

Visual Proof

Please provide a screenshot or video demonstrating that your changes work locally:

[Drag and drop your screenshot/video here or use the following format:]
[Screenshot description]

Related Issue

Fixes [Github issue link]

[If this corresponds to a fix from another Kernel OSS repo, include this:]

Fixes [Link to other repo]

[Replace with actual issue link, e.g., Fixes https://github.com/username/repo/issues/123]

Additional Notes

[Any additional context, concerns, or notes for reviewers]


TL;DR

Reorganized the CLI documentation, splitting the single reference page into multiple, command-specific pages for better navigation and clarity.

Why we made these changes

The existing CLI documentation was a single, long page, making it difficult for users to quickly find information about specific commands. This restructuring improves the developer experience by organizing commands into logical groups, making the documentation easier to read and reference.

What changed?

  • Decomposed the monolithic reference/cli.mdx into smaller, more focused pages.
  • Created new pages for each command group under reference/cli/:
    • apps.mdx
    • auth.mdx
    • browsers.mdx
  • Converted the main reference/cli.mdx into a landing page that links to the new documentation sections.
  • Restructured the reference/mcp-server.mdx documentation for better clarity.
  • Updated docs.json to reflect the new documentation hierarchy in the side navigation.

Description generated by Mesa. Update settings

Copy link
Contributor

@mesa-dot-dev mesa-dot-dev bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Performed full review of 27fdd58...c62a172

6 files reviewed | 0 comments | Review on Mesa | Edit Reviewer Settings

Copy link
Contributor

@dprevoznik dprevoznik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks for the edits on Claude section of MCP server page.

@masnwilliams masnwilliams merged commit 131c686 into main Sep 2, 2025
2 checks passed
@masnwilliams masnwilliams deleted the mason/cli-docs-organization branch September 2, 2025 16:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants