-
Notifications
You must be signed in to change notification settings - Fork 21
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
Update installation instructions for CMake #270
Conversation
To test, I ran `au-docs-serve`, and did an A/B comparison with respect to the currently deployed doc website. Looks like the table got updated correctly, the tabbed instructions work, and everything else was as expected. Fixes #215.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These instructions are very helpful. I rendered them locally. They look good. I left some nitpicks.
docs/install.md
Outdated
all_verify_interface_header_sets \ | ||
test | ||
``` | ||
The reason we recommend `FetchContent` is because it makes it easier for each project to get the |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This wording is a little clunky. It might be clearer to write something like
We recommend `FetchContent` because it gets the exact version and installs au for the project.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I tweaked it a little bit based on your recommendation.
docs/install.md
Outdated
We would like to support all these build and packaging systems, and perhaps others! But the initial | ||
public release is bazel-only, because bazel is what we use at Aurora, and we don't have experience | ||
with any of these alternatives. Thus, we'll need to lean on the community to support them. | ||
Now, here are the installation instructions. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't like the word Now
and these are all installation instructions. It might be better to delete this line.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done.
To test, I ran
au-docs-serve
, and did an A/B comparison with respectto the currently deployed doc website. Looks like the table got updated
correctly, the tabbed instructions work, and everything else was as
expected.
Fixes #215.