Skip to content

Commit

Permalink
Merge pull request #1422 from hannobraun/contributing
Browse files Browse the repository at this point in the history
Mention `just build` setup in `CONTRIBUTING.md`
  • Loading branch information
hannobraun authored Dec 6, 2022
2 parents 628c1e2 + c5638ea commit 475e709
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,11 @@ This requires [`just`](https://crates.io/crates/just), which you can install lik
cargo install just
```

There might be additional setup required, depending on the platform you develop on. For example, the following [was reported](https://github.com/hannobraun/Fornjot/pull/1342#issue-1447029944):

- > To make `just build` work on Windows I had to install [`Visual Studio` with `clang`](https://www.wikihow.com/Install-Clang-on-Windows) and then [`MinGW` with `ar`](https://winlibs.com/) and add both tools to `PATH` env var to make `cross-compiler` work.
- > On Linux, I had to install `libfontconfig-dev` and `clang`.
The purpose of `just build` is to run the same suite of checks and tests that the CI build runs, so you can figure out any issues in advance, without having to submit a pull request, and having to wait for a CI run to finish.

This is defined in [`justfile`](justfile). Please note that `justfile` is maintained in parallel to the CI configuration, and most deviations should be considered bugs in `justfile`.
Expand Down

0 comments on commit 475e709

Please sign in to comment.