-
-
Notifications
You must be signed in to change notification settings - Fork 9
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: update contributing guidelines (#125)
* docs: update contributing guidelines * lint
- Loading branch information
Showing
2 changed files
with
34 additions
and
36 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 |
---|---|---|
@@ -1,28 +1,33 @@ | ||
## How to contribute | ||
|
||
Thank you for considering contributing to coURLan! | ||
|
||
Here are some important resources: | ||
If you value this software or depend on it for your product, | ||
consider sponsoring it and contributing to its codebase. | ||
Your support will help ensure the sustainability and growth of the project. | ||
|
||
* [List of currently open issues](https://github.com/adbar/courlan/issues) (no pretention to exhaustivity!) | ||
* [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/) | ||
There are many ways to contribute: | ||
|
||
There are many ways to contribute, you could: | ||
* Sponsor the project: Show your appreciation [on GitHub](https://github.com/sponsors/adbar) or [ko-fi.com](https://ko-fi.com/adbarbaresi). | ||
* Find bugs and submit bug reports: Help making Courlan an even more robust tool. | ||
* Write code: Fix bugs or add new features by writing [pull requests](https://docs.github.com/en/pull-requests) with a list of what you have done. | ||
|
||
* Improve the documentation | ||
* Find bugs and submit bug reports | ||
* Submit feature requests | ||
* Write tutorials or blog posts | ||
* Write code | ||
|
||
## Submitting changes | ||
A special thanks to the [contributors](https://github.com/adbar/courlan/graphs/contributors) who have played a part in Courlan. | ||
|
||
Please send a [GitHub Pull Request to coURLan](https://github.com/adbar/courlan/pull/new/master) with a clear list of what you've done (read more about [pull requests](http://help.github.com/pull-requests/)). | ||
|
||
**Working on your first Pull Request?** See this tutorial: [How To Create a Pull Request on GitHub](https://www.digitalocean.com/community/tutorials/how-to-create-a-pull-request-on-github) | ||
## Testing and evaluating the code | ||
|
||
For further questions you can contact me by way of [GitHub issues](https://github.com/adbar/courlan/issues), [Twitter](https://twitter.com/adbarbaresi) or [E-Mail](https://adrien.barbaresi.eu/). | ||
Here is how you can run the tests and code quality checks. Pull requests will only be accepted if the changes are tested and if they there are no errors. | ||
|
||
1. Install the necessary packages with `pip install courlan[dev]` | ||
2. Run the tests and code quality tools: | ||
- Tests with `pytest` | ||
- Type checking with `mypy` on the directory: `mypy courlan/` | ||
- Code formatting with `black` on the directory as well | ||
|
||
|
||
For further questions you can use [GitHub issues](https://github.com/adbar/courlan/issues) or [E-Mail](https://adrien.barbaresi.eu/). | ||
|
||
Thanks, | ||
|
||
Adrien | ||
Adrien |
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