Improve CONTRIBUTING.md and the pull request template. (#1780)

We refer to CONTRIBUTING.md from the PR template now
which is now the single place containing all information.

Reference to the bot is removed since it is currently
not being used.

We point contributors to using clang-format.

We link to PR and code review best practices now.

Signed-off-by: Wolfgang Hess <whess@lyft.com>
master
Wolfgang Hess 2020-11-17 10:56:38 +01:00 committed by GitHub
parent b1ce24d3f8
commit dddb2f1102
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 24 additions and 15 deletions

View File

@ -1,14 +1,2 @@
Want to contribute? Great! Make sure you've read, understood and considered all Want to contribute? Great! Make sure you've read and understood
the points below before creating your PR: [CONTRIBUTING.md](https://github.com/cartographer-project/cartographer/blob/master/CONTRIBUTING.md).
- Keep your PR under 200 lines of code and address a single concern.
- Add unit test(s) and documentation (these do not count toward your 200 lines).
- Adhere to the [Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html).
- Run `ninja test` or `catkin_make_isolated --install --use-ninja --pkg cartographer --make-args test` as appropriate.
- Keep rebasing (or merging) of master branch to a minimum. It triggers Travis
runs for every update which blocks merging of other changes. Our merge bot
will rebase your branch, reformat your source code and merge as the last step
in the review process.
- Please replace this template text with the commit message you want for your
PR. You and/or the reviewer should keep it updated during the course of the
review using the GitHub edit feature.

View File

@ -27,4 +27,25 @@ You can sign-off a commit via `git commit -s`.
### Code reviews ### Code reviews
All submissions, including submissions by project members, require review. All submissions, including submissions by project members, require review.
We use GitHub pull requests for this purpose. We use GitHub pull requests for this purpose. Make sure you've read,
understood and considered all the points below before creating your PR.
#### Style guide
C++ code should adhere to the
[Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html).
You can handle the formatting part of the style guide via `git clang-format`.
#### Best practices
When preparing your PR and also during the code review make sure to follow
[best practices](https://google.github.io/eng-practices/review/developer/).
Most importantly, keep your PR under 200 lines of code and address a single
concern.
#### Testing
- Add unit tests and documentation (these do not count toward your 200 lines).
- Run `ninja test` or `catkin_make_isolated --install --use-ninja --pkg cartographer --make-args test` as appropriate.
- Keep rebasing (or merging) of master branch to a minimum. It triggers Travis
runs for every update which blocks merging of other changes.