DiscordTickets/.github/CONTRIBUTING.md

98 lines
4.5 KiB
Markdown
Raw Normal View History

# Contributing
2021-02-22 18:18:06 +02:00
**Table of contents**
2021-02-22 02:05:37 +02:00
- [Contributing](#contributing)
- [Submitting a bug report](#submitting-a-bug-report)
- [Submitting a feature request](#submitting-a-feature-request)
- [Creating a pull request](#creating-a-pull-request)
- [Contributing code](#contributing-code)
- [Translating](#translating)
- [Updating documentation](#updating-documentation)
- [Website](#website)
- [JSDoc](#jsdoc)
2021-02-22 02:08:18 +02:00
Thank you for considering contributing to DiscordTickets.
Before contributing, please read the [code of conduct](CODE_OF_CONDUCT.md), which all contributors must follow.
You don't need to write code to contribute; all contributions are welcome and encouraged. You could:
- [Submit a bug report](#submitting-a-bug-report) issue
- Help with bug triage
- [Request a new feature (or an improvement to an existing feature)](#submitting-a-feature-request)
2021-02-26 18:07:20 +02:00
- [Improve documentation](#updating-documentation) (the [website](https://discordtickets.app), or JSDoc comments)
2021-02-22 02:08:18 +02:00
- [Help translate](#translating)
- Create a tutorial (a video or page on the docs)
2021-03-03 12:57:28 +02:00
- [Answer someone's question in Discussions](https://github.com/discord-tickets/bot/discussions/categories/support-q-a?discussions_q=category%3A%22Support+%28Q%26A%29%22+is%3Aunanswered)
2021-02-22 02:08:18 +02:00
- Respond to an issue or pull request
2021-03-03 12:57:28 +02:00
If you want to contribute but don't know how, and this file doesn't answer your questions, [start a discussion](https://github.com/discord-tickets/bot/discussions/new) or [join the Discord support & community server](https://go.eartharoid.me/discord) to ask for guidance.
2021-02-15 20:34:59 +02:00
2021-02-22 02:05:37 +02:00
**Issues are for:**
2021-02-22 02:05:37 +02:00
- Bug reports
- Requesting changes to existing features
2021-02-22 02:05:37 +02:00
Please label your issues appropriately.
2021-02-22 02:05:37 +02:00
**Discussions are for:**
2021-02-22 02:05:37 +02:00
- Support (also on [Discord](https://go.eartharoid.me/discord))
- General questions (also on [Discord](https://go.eartharoid.me/discord))
- Requesting new features
2021-03-03 12:57:28 +02:00
Please read ["Welcome to DiscordTickets Discussions!"](https://github.com/discord-tickets/bot/discussions/77) before starting a discussion!
2021-02-22 02:05:37 +02:00
## Submitting a bug report
2021-03-03 12:57:28 +02:00
Issues should be used to report bugs. If you have found a bug, check to see if it has already been reported or resolved. If it hasn't, you can [create a new issue](https://github.com/discord-tickets/bot/issues/new/choose) using the "Bug report" template. Please include as much information as possible in your report.
2021-02-22 02:05:37 +02:00
## Submitting a feature request
2021-03-03 12:57:28 +02:00
To request a new feature, [start a new discussion](https://github.com/discord-tickets/bot/discussions/new?category=Ideas) under the Ideas category so other members of the community can discuss the request and vote on it.
2021-02-22 02:05:37 +02:00
2021-03-03 12:57:28 +02:00
If you would like to request changes to an existing feature, it may be better to [create an issue](https://github.com/discord-tickets/bot/issues/new) instead (use the `enhancement` label).
2021-02-22 02:05:37 +02:00
## Creating a pull request
2021-03-03 12:57:28 +02:00
To edit the documentation, translate, or contribute code to this project, you will need to [create a new pull request](https://github.com/discord-tickets/bot/compare). For large changes, you should **consider creating an issue** (or commenting on an existing one) first, as it could save you some time.
2021-02-22 02:05:37 +02:00
2021-02-22 18:18:06 +02:00
You should name your commits using [**this commit message format**](https://github.com/angular/material/blob/master/.github/CONTRIBUTING.md#-commit-message-format).
2021-02-22 02:05:37 +02:00
### Contributing code
Any code changes should be accompanied by any necessary documentation changes.
You should install the ESLint extension in your editor help you follow the code style.
- Use single quotes
2021-03-02 20:53:32 +02:00
- Classes should be named in PascalCase
2021-02-22 02:05:37 +02:00
- Functions should be named in camelCase
- Variables and constants should be named in snake_case
### Translating
Please try to keep the meaning of the translation as close to the original as possible.
2021-03-03 12:57:28 +02:00
1. Copy [`en-GB.json`](https://github.com/discord-tickets/bot/blob/master/src/locales/en-GB.json) and name it correctly
2021-02-22 02:05:37 +02:00
2. Without modifying the keys (left side of the colon), translate the values (on the right side of the colon).
3. [Create a pull request](#creating-a-pull-request)
### Updating documentation
#### Website
The documentation is written in Markdown, with extensions for additional features. See the [Material for MkDocs Reference](https://squidfunk.github.io/mkdocs-material/reference/abbreviations/) for details.
Please install a Markdown linting extension in your editor.
If you would like to see a live preview of your changes you can install MkDocs locally after cloning the repository (requires python).
1. Install with `pip install -r requirements.txt`
2. Run `mkdocs serve`
#### JSDoc
Feel free to improve or add JSDoc comments in the JavaScript files.