Skip to content

Commit

Permalink
add contributing docs
Browse files Browse the repository at this point in the history
  • Loading branch information
tomadamatkinson committed Feb 24, 2024
1 parent 386cfe3 commit 0e8b51d
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions CONTRIBUTING.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,28 @@ If you have a sample that demonstrates Vulkan like any of the above points, then
Before you start, check out the requirements and guidelines below.
Following these guidelines can help ensure that your contribution ends up being approved by reviewers and most importantly becomes a valuable addition to the Vulkan Samples repository.

== Quality Checks

Vulkan Samples has a range of quality checks to ensure that we maintain a consistent quality and style across all samples. These include formatting, linting and copyright checks.

To make this process as painless for contributors as possible we use xref:https://pre-commit.com/[pre-commit]. To install pre-commit and the hooks for this repository, run the following commands:

----
pip install pre-commit
pre-commit install
----

If you prefer not to use pre-commit, you can run the checks manually using the following commands:

----
# Run clang-format
./scripts/clang_format.py main
# Run copyright checks
./scripts/copyright.py main --fix
----

Future tooling may be added in the future. If you have any suggestions or feedback, please open an issue on the repository.

== Repository Structure

|===
Expand Down

0 comments on commit 0e8b51d

Please sign in to comment.