-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Sienna Lloyd <sienna@linux.com>
- Loading branch information
1 parent
50dfe58
commit 33221bf
Showing
14 changed files
with
748 additions
and
620 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
-P ubuntu-latest=ghcr.io/catthehacker/ubuntu:rust-latest | ||
--artifact-server-path artifacts |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,43 @@ | ||
# Contributing | ||
|
||
## Tools | ||
|
||
* [Rust](https://www.rust-lang.org/) | ||
* [clang](https://clang.llvm.org/) | ||
* [nextest](https://nexte.st/) | ||
* Optional | ||
* [llvm-cov](https://github.com/taiki-e/cargo-llvm-cov) | ||
* [act](https://github.com/nektos/act) (requires Docker or compatible) | ||
|
||
## Pull Request Process | ||
|
||
* Open a ticket to make sure the feature is needed | ||
* Fork the repository | ||
* Create a branch with a descriptive name that starts with the type of change | ||
* Use `feat/` for new features (or anything that adds functionality) | ||
* Use `bug/` for bug fixes | ||
* Use `refactor/` for refactors | ||
* Use `doc/` for documentation changes | ||
* Use `test/` for test changes | ||
* Make your changes | ||
* Write tests | ||
* Format your code with `cargo fmt` | ||
* Commit your changes | ||
* Optionally: validate your changes ahead of time with `act pull_request` | ||
|
||
Validating your changes ahead of time is both faster and more resource intensive than waiting for the GHA runners. While it's faster (GHA jobs take nearly 20m), it's also more resource intensive. It's recommended the Docker host have at least 4 cores and 8GB of RAM or it won't be much faster than GHA runners. | ||
|
||
## Coding Style | ||
|
||
### General | ||
|
||
* Use `cargo fmt` to format your code | ||
|
||
### Hot Paths | ||
|
||
For hot paths, we use the following rules: | ||
* never use `String`, `str`, or other heap-allocated types | ||
For hot paths, I have the following rules: | ||
* Never use heap-allocated types | ||
|
||
### Workflows | ||
|
||
When possible, it's best to ensure that your workflows will work locally with `act`. You can separate local vs GHA steps via `if: github.actor == 'nektos/act'` for local steps and `if: github.actor != 'nektos/act'` for GHA steps. |
Oops, something went wrong.