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

README: Documentation improvements #304

Merged
merged 6 commits into from
Jun 21, 2022
Merged

README: Documentation improvements #304

merged 6 commits into from
Jun 21, 2022

Conversation

woodruffw
Copy link
Member

Closes #303.

Signed-off-by: William Woodruff <william@trailofbits.com>
Signed-off-by: William Woodruff <william@trailofbits.com>
@woodruffw woodruffw added the component:docs Documentation components label Jun 16, 2022
@woodruffw woodruffw requested review from di and tetsuo-cpp June 16, 2022 16:10
@woodruffw woodruffw self-assigned this Jun 16, 2022
@woodruffw woodruffw enabled auto-merge (squash) June 17, 2022 14:33
Comment on lines +21 to +34
* [Features](#features)
* [Installation](#installation)
* [Third-party packages](#third-party-packages)
* [GitHub Actions](#github-actions)
* [`pre-commit` support](#pre-commit-support)
* [Usage](#usage)
* [Exit codes](#exit-codes)
* [Dry runs](#dry-runs)
* [Examples](#examples)
* [Troubleshooting](#troubleshooting)
* [Security model](#security-model)
* [Licensing](#licensing)
* [Contributing](#contributing)
* [Code of Conduct](#code-of-conduct)
Copy link
Member

Choose a reason for hiding this comment

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

Just an FYI that these won't work when the README is displayed on PyPI: pypa/readme_renderer#169

Copy link
Member Author

Choose a reason for hiding this comment

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

Yeah, that was in the back of my mind...

IMO that's an acceptable tradeoff for now, since we also direct-link to the repo in a few places (like the GitHub Action).

README.md Outdated Show resolved Hide resolved
Signed-off-by: William Woodruff <william@trailofbits.com>
@woodruffw woodruffw requested a review from di June 21, 2022 14:09
@woodruffw woodruffw merged commit c136126 into main Jun 21, 2022
@woodruffw woodruffw deleted the ww/doc-improvements branch June 21, 2022 14:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:docs Documentation components
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Documentation] Possible JSON Format Output Alternative
2 participants