keeweb/CONTRIBUTING.md

61 lines
2.7 KiB
Markdown
Raw Normal View History

2017-11-13 23:04:42 +01:00
# Contributing to KeeWeb
Thanks for taking the time to contribute! :gift:
2020-04-18 12:40:10 +02:00
There are different ways to help the project, you will find a summary here.
2017-11-13 23:04:42 +01:00
## Code of conduct
2020-04-18 12:40:10 +02:00
This project and everyone participating in it is governed by the [KeeWeb Code of Conduct](https://github.com/keeweb/keeweb/blob/master/.github/CODE_OF_CONDUCT.md#readme).
By participating, you are expected to uphold this code. Please report unacceptable behavior to antelle.net@gmail.com.
2017-11-13 23:04:42 +01:00
## Issues
First, let's check if it's [already there](https://github.com/keeweb/keeweb/issues).
Perhaps, someone has already reported it?
2020-04-18 12:40:10 +02:00
[Click here](https://github.com/keeweb/keeweb/issues/new/choose) to create a new issue.
2017-11-13 23:04:42 +01:00
When creating issues, please answer some questions asked on that page.
2019-08-18 08:17:32 +02:00
They will help to understand, reproduce, and fix your issue.
2017-11-13 23:04:42 +01:00
2020-04-18 12:40:10 +02:00
## Reporting vulnerabilities
We would appreciate [responsible disclosure](https://en.wikipedia.org/wiki/Responsible_disclosure).
If you would like to report a vulnerability, the preferred way to do so is [contacting the developer directly](antelle.net@gmail.com).
2017-11-13 23:04:42 +01:00
## Questions, great ideas, etc...
2020-04-18 12:40:10 +02:00
You can [create an issue](https://github.com/keeweb/keeweb/issues/new/choose) to discuss any topic.
2017-11-13 23:04:42 +01:00
Indeed, questions on that page are not applicable in this case.
2020-04-18 12:47:00 +02:00
## Development
We don't accept (and in forseeable future, we won't) anyone as a project collaborator directly.
Instead, the code should be contributed via pull requests. To get started with development, take a look at these pages:
- [Architecture](https://github.com/keeweb/keeweb/wiki/Architecture)
- [Engineering](https://github.com/keeweb/keeweb/wiki/Engineering)
2020-04-18 12:47:28 +02:00
- [Unsupported Features](https://github.com/keeweb/keeweb/wiki/Unsupported%20Features)
2020-04-18 12:47:00 +02:00
- [Pull Request Guidelines](https://github.com/keeweb/keeweb/blob/master/.github/PULL_REQUEST_TEMPLATE.md#readme)
2017-11-13 23:04:42 +01:00
## Pull requests
Please follow [this guide](https://github.com/keeweb/keeweb/blob/master/.github/PULL_REQUEST_TEMPLATE.md#readme).
2017-11-13 23:09:09 +01:00
## Docs (Wiki pages)
KeeWeb has [Wiki pages](https://github.com/keeweb/keeweb/wiki), however it's not possible to contribute with pull requests.
2020-04-18 12:40:10 +02:00
If you would like to improve it, please [open an issue](https://github.com/keeweb/keeweb/issues/new/choose) and submit your changes in Markdown format.
## Donations
There are two ways of donating:
- join as backer on [OpenCollective](https://opencollective.com/keeweb#support);
- sponsor the developer directly on [GitHub](https://github.com/sponsors/antelle).
Please note: donation does not imply any type of service contract.
## Translations
All of KeeWeb translations are contributed by community. To improve a translation or add a missing one,
join our project on [OneSky](https://keeweb.oneskyapp.com).