improve CONTRIBUTING.md (#181)

This commit is contained in:
饺子w
2019-04-04 23:03:21 +08:00
committed by GitHub
parent e9bbe17fa4
commit 69f1d721f2
2 changed files with 53 additions and 5 deletions

View File

@@ -2,10 +2,54 @@
Thanks for your interest in Gotify!
When contributing to gotify/\*, please first discuss the change (typos excluded) you wish to make via issue, chat
or any other method with the owners of this repository. If you want to fix an already existing issue please write
so in a comment.
First of all, please note that we have a [code of conduct](CODE_OF_CONDUCT.md), please follow it in all your interactions with the project.
Please note we have a [code of conduct](CODE_OF_CONDUCT.md), please follow it in all your interactions with the project.
If you have any questions you can join the chat on [#gotify:matrix.org](https://matrix.to/#/#gotify:matrix.org).
If you have any questions you can join the chat on [#gotify:matrix.org](https://matrix.to/#/#gotify:matrix.org).
## Where to Contribute
| Repository| Description| Technology|
| ---| ---| ---|
|[gotify/server](https://github.com/gotify/server) |server implementation and WebUI code |`Go` `Typescript` `React`|
|[gotify/android](https://github.com/gotify/android) |android client implementation |`Java` `Android` |
|[gotify/plugin-template](https://github.com/gotify/plugin-template)|official gotify plugin template |`Go` |
|[gotify/cli](https://github.com/gotify/cli) |official CLI client |`Go` |
|[gotify/website](https://github.com/gotify/website) |documentaion [gotify.net](https://gotify.net/)|`Markdown` `Docusaurus` |
|[gotify/contrib](https://github.com/gotify/contrib) |community-contributed projects |`misc` |
## Ways to Contribute
### Document Refinements
_Keywords: **Documentation**, **Writing**_
Documents are residing in the [gotify/website](https://github.com/gotify/website) repository. Open an issue or PR and indicate the part of the document you are working on or the information you want to add to the document.
### Feature Request and implementation
_Keywords: **Features**, **Coding**_
When proposing features to gotify/\*, please first discuss the change you wish to make via issue, chat or any other method with the maintainers.
After the feature request is approved, file an issue or comment under the existing one indicating whether you want to submit the implementation yourself. If you decided not to, the maintainers would evaluate the necessity and urgency of the feature and decide whether to wait for another contributor to claim the request or commit an implementation himself/herself.
### Bug Reports and Fixes
_Keywords: **Bug Hunt**, **Coding**_
If you are not sure if the problem you are facing is indeed a bug, we recommend discussing it in the [community chat]((https://matrix.to/#/#gotify:matrix.org)) first, opening an issue is also welcome.
After the bug is confirmed, please file a new or comment under the existing issue describing the bug and indicate whether you want to sumbit the fix yourself.
If you want to submit a fix to an already confirmed issue, please indicate that you wish to submit a PR in a comment before starting your work.
### Community Contribution Projects
_Keywords:_ **Features**, **Coding**, **Writing**
Make gotify more powerful and easy-to-use than ever by:
- writing a [plugin](https://gotify.net/docs/plugin)
- writing a client (smartphones, Windows, Linux, Browser Add-on, etc.)
- writing about how you have used gotify for your applications
Also, after you have finished, consider submitting your hard work to the community contributions [repository](https://github.com/gotify/contrib) so that more users can make a use of it.

View File

@@ -56,6 +56,10 @@ We wanted a simple server for sending and receiving messages (in real time per W
[REST-API](https://gotify.net/api-docs) ᛫
[Setup Dev Environment](https://gotify.net/docs/dev-setup)
## Contributing
We welcome all kinds of contribution, including bug reports, feature requests, documentation improvements, UI refinements, etc. Check out [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the
[tags on this repository](https://github.com/gotify/server/tags).