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

(DOCS) Add CLI reference documentation #120

Merged
merged 1 commit into from
Aug 4, 2023
Merged

(DOCS) Add CLI reference documentation #120

merged 1 commit into from
Aug 4, 2023

Conversation

michaeltlombardi
Copy link
Collaborator

PR Summary

This change adds reference documentation for the dsc CLI. It references the output schemas, which are being added in #94.

PR Context

I did some initial investigation on auto-generating reference documentation from the code and found little useful support for exporting Markdown. The best option seems to be exporting to ROFF and then converting. For now, I've hand-written the documentation and we can investigate porting the docs into the structs that define the application's arguments and commands in the future.

@michaeltlombardi
Copy link
Collaborator Author

This will need to be updated after #114 merges.

Copy link

@sdwheeler sdwheeler left a comment

Choose a reason for hiding this comment

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

LGTM

@michaeltlombardi
Copy link
Collaborator Author

Updated to include changes from #114 and examples for each command.

Copy link

@sdwheeler sdwheeler left a comment

Choose a reason for hiding this comment

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

LGTM

This change adds reference documentation for the `dsc` CLI. It references the
output schemas, which are being added in #94.
@SteveL-MSFT SteveL-MSFT merged commit b62be40 into PowerShell:main Aug 4, 2023
4 checks passed
@SteveL-MSFT SteveL-MSFT deleted the docs/main/cli branch August 4, 2023 17:07
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.

None yet

3 participants