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

[Feature Request] Support Markdown in CLI help output in terminal #687

Open
yuandrew opened this issue Oct 2, 2024 · 0 comments
Open

[Feature Request] Support Markdown in CLI help output in terminal #687

yuandrew opened this issue Oct 2, 2024 · 0 comments
Labels
enhancement New feature or request

Comments

@yuandrew
Copy link
Contributor

yuandrew commented Oct 2, 2024

Is your feature request related to a problem? Please describe.

Once the Documentation information is generated from the CLI repo, it would be nice to have the CLI --help output to output Markdown formatting.

Describe the solution you'd like

It may be tricky figuring out how to support all types of terminals. We need to ensure the older terminals with minimal functionality can support this feature.

Additional context

@yuandrew yuandrew added the enhancement New feature or request label Oct 2, 2024
yuandrew added a commit that referenced this issue Oct 8, 2024
## What was changed
Auto generate all of the *.mdx files present in the current
documentation repo. index.mdx is not auto-generated

IMPORTANT: The generated files are not yet being consumed anywhere. A
future PR will auto-publish a PR into the docs repo whenever there is a
docs related change.

Added a field in the YML to indicate doc-specific information, like SEO
related keywords and descriptions.

Removed `cmd-options.cdx` and print each command option description
inline in each file instead.
temporalio/documentation#3122 removes all
references to this file from the documentation side.

## Why?
This is in a larger effort to have the CLI be the source of truth for
docs, and have the documentation auto-ingest any CLI changes, keeping
all information in sync.

This is the first step to this goal, there are a number of follow up
tasks that I wanted to split up from this PR:
1. Diff the current information on the docs with the CLI, and unify into
a single master-description for each command.
2. Auto-publish PR to docs repo whenever there is a CLI doc change
1. Auto update sidebars.js and vercel.js whenever a new temporal command
is added.
3. Clean up the SEO keywords/tags - being handled by the documentation
team
4. Support markdown in the CLI help output in terminal #687

## Checklist
7. Any docs updates needed?
<!--- update README if applicable
      or point out where to update docs.temporal.io -->
For now, docs will not be updated. There will be a future PR that
auto-creates a PR into the documentation repo with any updates.

---------

Co-authored-by: David Reiss <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant