doc: refine contributing
Signed-off-by: Brian McGee <brian@bmcgee.ie>
This commit is contained in:
parent
dc63ac923c
commit
8b21b3a280
|
@ -8,26 +8,27 @@ This file contains instructions that will help you make a contribution.
|
|||
|
||||
## Licensing
|
||||
|
||||
The treefmt binaries and this user guide are licensed under the [MIT license](https://numtide.github.io/treefmt/LICENSE.html).
|
||||
The `treefmt` binaries and this user guide are licensed under the [MIT license](https://numtide.github.io/treefmt/LICENSE.html).
|
||||
|
||||
## Before you contribute
|
||||
|
||||
Here you can take a look at the [existing issues](https://github.com/numtide/treefmt/issues). Feel free to contribute, but make sure you have a [GitHub account](https://github.com/join) first :) .
|
||||
Here you can take a look at the [existing issues](https://github.com/numtide/treefmt/issues). Feel free to contribute, but make sure you have a
|
||||
[GitHub account](https://github.com/join) first :slightly_smiling_face:.
|
||||
|
||||
If you're new to open source, please read GitHub's guide on [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/). It's a quick read, and it's a great way to introduce yourself to how things work behind the scenes in open-source projects.
|
||||
If you're new to open source, please read GitHub's guide on [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/). It's a quick read,
|
||||
and it's a great way to introduce yourself to how things work behind the scenes in open-source projects.
|
||||
|
||||
Before sending a pull request, make sure that you've read all the guidelines. If you don't understand something, please [state your question clearly in an issue](https://github.com/numtide/treefmt/issues/new) or ask the community on the [treefmt matrix server](https://matrix.to/#/#treefmt:numtide.com).
|
||||
Before sending a pull request, make sure that you've read all the guidelines. If you don't understand something, please
|
||||
[state your question clearly in an issue](https://github.com/numtide/treefmt/issues/new) or ask the community on the [treefmt matrix server](https://matrix.to/#/#treefmt:numtide.com).
|
||||
|
||||
## Creating an issue
|
||||
|
||||
If you need to create an issue, make sure to clearly describe it, including:
|
||||
|
||||
- The steps to reproduce it if it's a bug
|
||||
- The version of treefmt used
|
||||
- The database driver and version
|
||||
- The database version
|
||||
- The steps to reproduce it (if it's a bug)
|
||||
- The version of `treefmt` used
|
||||
|
||||
The cache database is stored in a toml file the ~/.cache/treefmt directory.
|
||||
The cache database is stored in a `.db` file in the `~/.cache/treefmt/eval-cache` directory.
|
||||
|
||||
## Making changes
|
||||
|
||||
|
@ -36,7 +37,7 @@ If you want to introduce changes to the project, please follow these steps:
|
|||
- Fork the repository on GitHub
|
||||
- Create a branch on your fork. Don't commit directly to main
|
||||
- Add the necessary tests for your changes
|
||||
- Run treefmt in the source directory before you commit your changes
|
||||
- Run `treefmt` in the source directory before you commit your changes
|
||||
- Push your changes to the branch in your repository fork
|
||||
- Submit a pull request to the original repository
|
||||
|
||||
|
@ -44,10 +45,6 @@ Make sure you based your commits on logical and atomic units!
|
|||
|
||||
## Examples of git history
|
||||
|
||||
Git history that we want to have:
|
||||
|
||||
Git history that we are trying to avoid:
|
||||
|
||||
<details>
|
||||
|
||||
<summary>Git history that we want to have</summary>
|
||||
|
@ -88,7 +85,7 @@ Git history that we are trying to avoid:
|
|||
|
||||
<details>
|
||||
|
||||
<summary>Git history that we are <b>trying</b> to avoid:</summary>
|
||||
<summary>Git history that we are <b>trying</b> to avoid</summary>
|
||||
|
||||
```
|
||||
|
||||
|
|
Reference in New Issue
Block a user