alex/cacao
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

Mark how to run the nightly version of tools, and fix some text (#95)

Browse source
This commit is contained in:
Adam Gastineau 2023-07-13 17:07:40 -07:00 committed by GitHub
parent 9f8d946371
commit aedcfe1c65
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
CONTRIBUTING.md
View file

@ -13,7 +13,7 @@ Have a look at the [issue tracker](https://github.com/ryanmcgrath/cacao/issues).
describing your problem (or a very similar one) there, please open a new issue with describing your problem (or a very similar one) there, please open a new issue with
the following details: the following details:
- Which versions of Rust and cacao (and macOS/iOS build/device) are you using? - Which versions of Rust and Cacao (and macOS/iOS build/device) are you using?
- Which feature flags are you using? - Which feature flags are you using?
- What are you trying to accomplish? - What are you trying to accomplish?
- What is the full error you are seeing? - What is the full error you are seeing?
@ -34,17 +34,17 @@ If you can't find an issue (open or closed) describing your idea on the [issue
tracker], open an issue. Adding answers to the following tracker], open an issue. Adding answers to the following
questions in your description is +1: questions in your description is +1:
- What do you want to do, and how do you expect Alchemy to support you with that? - What do you want to do, and how do you expect Cacao to support you with that?
- How might this be added to Alchemy? - How might this be added to Cacao?
- What are possible alternatives? - What are possible alternatives?
- Are there any disadvantages? - Are there any disadvantages?
Thank you! Thank you!
## Contribute code to Alchemy ## Contribute code to Cacao
### Setting up cacao locally ### Setting up Cacao locally
1. Install Rust. Stable should be fine. 1. Install Rust. Stable should be fine.
2. Clone this repository and open it in your favorite editor. 2. Clone this repository and open it in your favorite editor.
@ -57,8 +57,7 @@ In a few cases, though, it's fine to deviate - a good example is branching match
To run rustfmt tests locally: To run rustfmt tests locally:
1. Use rustup to set rust toolchain to the version specified in the 1. Use rustup to set Rust toolchain to the latest stable version of Rust.
[rust-toolchain file](./rust-toolchain).
2. Install the rustfmt and clippy by running 2. Install the rustfmt and clippy by running
``` ```
@ -66,18 +65,18 @@ To run rustfmt tests locally:
rustup component add clippy-preview rustup component add clippy-preview
``` ```
3. Run clippy using cargo from the root of your alchemy repo. 3. Run clippy nightly using cargo from the root of your Cacao repo.
``` ```
cargo clippy cargo +nightly clippy
``` ```
Each PR needs to compile without warning. Each PR needs to compile without warning.
4. Run rustfmt using cargo from the root of your alchemy repo. 4. Run rustfmt nightly using cargo from the root of your Cacao repo.
To see changes that need to be made, run To see changes that need to be made, run
``` ```
cargo fmt --all -- --check cargo +nightly fmt --all -- --check
``` ```
If all code is properly formatted (e.g. if you have not made any changes), If all code is properly formatted (e.g. if you have not made any changes),
@ -89,15 +88,15 @@ To run rustfmt tests locally:
Once you are ready to apply the formatting changes, run Once you are ready to apply the formatting changes, run
``` ```
cargo fmt --all cargo +nightly fmt --all
``` ```
You won't see any output, but all your files will be corrected. You won't see any output, but all your files will be corrected.
You can also use rustfmt to make corrections or highlight issues in your editor. You can also use rustfmt to make corrections or highlight issues in your editor.
Check out [their README](https://github.com/rust-lang-nursery/rustfmt) for details. Check out [their README](https://github.com/rust-lang/rustfmt) for details.
### Notes ### Notes
This project prefers verbose naming, to a certain degree - UI code is read more often than written, so it's This project prefers verbose naming, to a certain degree - UI code is read more often than written, so it's
worthwhile to ensure that it scans well. It also maps well to existing Cocoa/cacao idioms and is generally preferred. worthwhile to ensure that it scans well. It also maps well to existing Cocoa/Cacao idioms and is generally preferred.