Files
yaml-cpp/CONTRIBUTING.md
Jesse Beder 8a9a7b74ef Update CONTRIBUTING.md
Add some details about testing.
2024-12-22 16:16:07 -06:00

1.5 KiB

Style

This project is formatted with clang-format using the style file at the root of the repository. Please run clang-format before sending a pull request.

In general, try to follow the style of surrounding code. We mostly follow the Google C++ style guide.

Commit messages should be in the imperative mood, as described in the Git contributing file:

Describe your changes in imperative mood, e.g. "make xyzzy do frotz" instead of "[This patch] makes xyzzy do frotz" or "[I] changed xyzzy to do frotz", as if you are giving orders to the codebase to change its behaviour.

Tests

Please verify the tests pass by configuring CMake with -D YAML_CPP_BUILD_TESTS=ON and running the target test/yaml-cpp-tests.

If you are adding functionality, add tests accordingly. Note that the "spec tests" are reserved for examples directly from the YAML spec, so if you have new examples, put them in other test files.

Pull request process

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.