CONTRIBUTING.md (1315B)
1 # Style 2 3 This project is formatted with [clang-format][fmt] using the style file at the root of the repository. Please run clang-format before sending a pull request. 4 5 In general, try to follow the style of surrounding code. We mostly follow the [Google C++ style guide][cpp-style]. 6 7 Commit messages should be in the imperative mood, as described in the [Git contributing file][git-contrib]: 8 9 > Describe your changes in imperative mood, e.g. "make xyzzy do frotz" 10 > instead of "[This patch] makes xyzzy do frotz" or "[I] changed xyzzy 11 > to do frotz", as if you are giving orders to the codebase to change 12 > its behaviour. 13 14 [fmt]: http://clang.llvm.org/docs/ClangFormat.html 15 [cpp-style]: https://google.github.io/styleguide/cppguide.html 16 [git-contrib]: http://git.kernel.org/cgit/git/git.git/tree/Documentation/SubmittingPatches?id=HEAD 17 18 # Tests 19 20 Please verify the tests pass by running the target `tests/run_tests`. 21 22 If you are adding functionality, add tests accordingly. 23 24 # Pull request process 25 26 Every pull request undergoes a code review. Unfortunately, github's code review process isn't great, but we'll manage. During the code review, if you make changes, add new commits to the pull request for each change. Once the code review is complete, rebase against the master branch and squash into a single commit.