Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Generate CLI reference for documentation #5685

Merged
merged 1 commit into from
Aug 1, 2024
Merged

Generate CLI reference for documentation #5685

merged 1 commit into from
Aug 1, 2024

Conversation

zanieb
Copy link
Member

@zanieb zanieb commented Aug 1, 2024

Loosely based on Cargo's format

Screenshot 2024-08-01 at 9 44 03 AM

Future work includes:

  • Grouping options
  • Enforcing some sort of specific command ordering
  • Showing possible values for enums
  • Adding "long_about" to commands for more context

@zanieb zanieb added documentation Improvements or additions to documentation preview Experimental behavior labels Aug 1, 2024
@zanieb
Copy link
Member Author

zanieb commented Aug 1, 2024

Notably the top-level preview commands are excluded because they're hidden

@zanieb zanieb force-pushed the zb/docs-reference branch 2 times, most recently from e59bbfc to 693cffc Compare August 1, 2024 14:59
@zanieb zanieb marked this pull request as ready for review August 1, 2024 15:05
@@ -147,3 +147,20 @@ See https://github.com/astral-sh/uv/issues/5130 */
.md-nav__link--active {
font-weight: bold;
}

/* Styling for the generated CLI reference page */
Copy link
Member Author

Choose a reason for hiding this comment

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

I created a custom class, these have ~no reliance on mkdocs material

Copy link
Member

@ibraheemdev ibraheemdev left a comment

Choose a reason for hiding this comment

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

Love this.

@eth3lbert
Copy link
Contributor

Great! I think I can help with future work part once we've finalized the grouping and ordering.

@zanieb zanieb enabled auto-merge (squash) August 1, 2024 15:57
@zanieb zanieb merged commit f107406 into main Aug 1, 2024
57 checks passed
@zanieb zanieb deleted the zb/docs-reference branch August 1, 2024 16:04
zanieb added a commit that referenced this pull request Aug 1, 2024
Joining #5685 in a dedicated reference section
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation preview Experimental behavior
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants