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

Add style guide #164

Merged
merged 3 commits into from
Aug 19, 2023
Merged

Add style guide #164

merged 3 commits into from
Aug 19, 2023

Conversation

chiphogg
Copy link
Contributor

@chiphogg chiphogg commented Aug 5, 2023

I skimmed through the Google C++ style guide, and looked for any
differences in how we do things. I called out the ones I found. We can
add more here as we encounter them.

The result can be previewed here:
https://github.com/aurora-opensource/au/blob/style-guide%2322/CONTRIBUTING.md#style-guide

To test, I clicked every link. They all go to the right anchor,
although some of the later ones seemed to be a little "off" to me in
their location. However, the link is definitely correct, so I think
this is a quirk we can't do anything about.

Fixes #22.

I skimmed through the Google C++ style guide, and looked for any
differences in how we do things.  I called out the ones I found.  We can
add more here as we encounter them.

Fixes #22.
@chiphogg chiphogg added the release notes: 📝 documentation PR affecting library documentation label Aug 5, 2023
Change "the Google style guide" to "the Google C++ Style Guide" (line 58). (We try to use publications' and institutions' preferred styling when we refer to them)
Copy link
Contributor

@johnzoppina johnzoppina left a comment

Choose a reason for hiding this comment

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

This looks good to me. Extra credit would be to make these list items parallel (for me, that means human subjects vs. non-human subjects, followed by parts of speech)

@chiphogg
Copy link
Contributor Author

This looks good to me. Extra credit would be to make these list items parallel (for me, that means human subjects vs. non-human subjects, followed by parts of speech)

Sorry, I didn't quite understand the extra credit part. 😅

@chiphogg
Copy link
Contributor Author

This looks good to me. Extra credit would be to make these list items parallel (for me, that means human subjects vs. non-human subjects, followed by parts of speech)

Sorry, I didn't quite understand the extra credit part. 😅

Synced offline. The extra credit was about resolving inconsistencies in style, but since this wasn't trivial I decided to pass.

@chiphogg chiphogg merged commit ba500ff into main Aug 19, 2023
9 checks passed
@chiphogg chiphogg deleted the style-guide#22 branch August 19, 2023 00:43
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.

Document style guide
3 participants