DiscordTickets/.github/CONTRIBUTING.md

96 lines
4.6 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-03-15 23:12:58 +02:00
Thank you for considering contributing to Discord Tickets.
2021-02-22 02:08:18 +02:00
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-15 23:12:58 +02:00
Please read ["Welcome to Discord Tickets 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
2021-04-27 13:27:03 +03:00
Please try to keep the meaning of the translation as close to the original as possible. If you want to change the meaning, you can customise your local files after.
2021-02-22 02:05:37 +02:00
2021-04-27 13:27:03 +03:00
Create an account on [i18n.discordtickets.app](https://i18n.discordtickets.app/) to get started. Ask on [Discord](https://go.eartharoid.me/discord) or in the [discussions](https://github.com/discord-tickets/bot/discussions) to get a new language added.
2021-02-22 02:05:37 +02:00
### 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.