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

Update installation instructions for CMake #270

Merged
merged 2 commits into from
Jul 22, 2024
Merged

Conversation

chiphogg
Copy link
Contributor

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.

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.
@chiphogg chiphogg added the release notes: 📝 documentation PR affecting library documentation label Jul 22, 2024
@chiphogg chiphogg requested a review from geoffviola July 22, 2024 17:18
Copy link
Contributor

@geoffviola geoffviola left a 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
Copy link
Contributor

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.

Copy link
Contributor Author

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.
Copy link
Contributor

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.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done.

@chiphogg chiphogg merged commit 569da0a into main Jul 22, 2024
11 checks passed
@chiphogg chiphogg deleted the chiphogg/doc-cmake#215 branch July 22, 2024 19:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release notes: 📝 documentation PR affecting library documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add support for building with CMake
2 participants