Skip to content

Commit 4c4c98f

Browse files
committed
Add contributing instructions
1 parent 44e95c6 commit 4c4c98f

File tree

2 files changed

+44
-0
lines changed

2 files changed

+44
-0
lines changed

CONTRIBUTING.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# Contributing
2+
3+
I hope that you've enjoyed reading these solutions as much as I enjoyed writing them.
4+
They're pretty fast and clean...but can you make them even *faster and cleaner*?
5+
6+
If you've made an improvement then please
7+
[open a pull request](https://github.com/maneatingape/advent-of-code-rust/compare).
8+
Contributions are encouraged and valued. ❤️
9+
10+
11+
It should generally fall into one of the following two categories:
12+
13+
* 🪲 **Bug Fix** Solutions try to be as general as possible but can't test for every input.
14+
Your pull request fixes an incorrect answer for your input or prevents a panic.
15+
* 🚀 **Performance Improvement** Your pull request gives a significant performance
16+
improvement. This could be achieved by using a better algorithm, better low level optimizations,
17+
by applying the portable SIMD library or by any other means!
18+
19+
## Legal Notice
20+
21+
When contributing to this project, you must agree that you have authored 100% of the content,
22+
that you have the necessary rights to the content and that the content you contribute
23+
may be provided under the project licence.
24+
25+
## Guidelines
26+
27+
Pull requests should meet the following baseline standards:
28+
29+
* Commit messages and pull request title are clear and informative.
30+
* Code style matches the existing code. This one is somewhat subjective but try to "fit in" by
31+
using the same naming conventions. Code should be portable, avoiding any architecture
32+
specific intrinsics.
33+
* Unit tests pass.
34+
* Code is formatted using `rustfmt`.
35+
* Code is linted using `clippy`.
36+
37+
Formatting and linting can be executed by running [`just`](https://github.com/casey/just)
38+
(if installed) on the command line at the project root, or alternatively copying and pasting
39+
the commands from [`justfile`](justfile) into the terminal.

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,11 @@ Place input files in `input/yearYYYY/dayDD.txt` including leading zeroes. For ex
5050

5151
</details>
5252

53+
## Contributing
54+
55+
Improvements to solutions are always appreciated. Please see the
56+
[detailed instructions](CONTRIBUTING.md) on how to get started.
57+
5358
## Performance
5459

5560
Benchmarks are measured using the built-in `cargo bench` tool run on an [Apple M2 Max][apple-link].

0 commit comments

Comments
 (0)