monkeytype/CONTRIBUTING.md

63 lines
3.4 KiB
Markdown
Raw Normal View History

2020-09-15 22:28:15 +08:00
# Contributing
### **Table of Contents**
- [Getting Started](#getting-started)
- [How to Contribute](#how-to-contribute)
- [Standards and Guidelines](#standards-and-guidelines)
2021-07-13 06:17:12 +08:00
- [Theme Guidelines](#theme-guidelines)
- [Language Guidelines](#language-guidelines)
- [Quote Guidelines](#quote-guidelines)
- [Questions](#questions)
## Getting Started
When contributing to Monkeytype, it's good to know our best practices, tips, and tricks. First, Monkeytype is written in ~~JavaScript~~ TypeScript, CSS, and HTML (in order of language usage within the project); thus, we assume you are comfortable in these languages or have basic knowledge of them. Our backend is in NodeJS and we use MongoDB to store our user data. Firebase is used for authentication. Redis is used to store daily leaderboard data. Furthermore, we use Prettier to format our code.
## How to Contribute
2021-07-13 06:17:12 +08:00
We have two separate contribution guides based on what you're looking to contribute. If you're simply looking to help us augment our language or quotes data, please refer to [CONTRIBUTING_BASIC.md](./CONTRIBUTING_BASIC.md). This guide will go over how to do so easily, and without the need to set up a local development server.
If you're looking to make deeper code changes that affect functionality, or will require screenshots of the changes, please refer to [CONTRIBUTING_ADVANCED.md](./CONTRIBUTING_ADVANCED.md).
2022-01-29 21:41:42 +08:00
2021-09-29 08:48:42 +08:00
## Standards and Guidelines
Below are a set of general guidelines for different types of changes.
### Theme Guidelines
2021-07-13 06:17:12 +08:00
<!-- TODO: add screenshots to provide examples for dos and don'ts -->
2021-07-13 06:17:12 +08:00
2021-10-07 21:30:52 +08:00
Before submitting a theme make sure...
2021-09-29 08:44:41 +08:00
- your theme is unique and isn't visually similar to any we already have.
- the text color is either black or white (or very close to these colors)
- your theme has been added to the `_list` file and the `textColor` property is the theme's main color
- your theme is clear and readable with both `flip test colors` and `colorful mode` enabled and disabled
(If you want to contribute themes but don't know how, check [THEMES.md](./THEMES.md))
### Language Guidelines
2021-07-13 06:17:12 +08:00
- Do not include swear words
- Ensure that your contribution meets JSON standards (no trailing comma at the end of a list)
- Be sure to add your language to the `_list` and `_groups` files
- Make sure the number of words in the file corresponds to the file name (for example: `languageName.json` is 200 words, `languageName_1k.json` is 1000 words, and so on)
(If you want to contribute languages but don't know how, check [LANGUAGES.md](./LANGUAGES.md))
### Quote Guidelines
- Do not include content that contains any libelous or otherwise unlawful, abusive or obscene text.
- Ensure that your contribution meets JSON standards (no trailing comma at the end of a list)
- Verify quotes added aren't duplicates of any already present
- Verify the `length` property is correct (length of the text in characters)
- Verify the `id` property is incremented correctly
- Please do not add extremely short quotes (less than 60 characters)
(If you want to contribute quotes but don't know how, check [QUOTES.md](./QUOTES.md))
2022-03-19 22:27:59 +08:00
2020-09-15 22:28:15 +08:00
## Questions
If you have any questions, comments, concerns, or problems let me know on [GitHub](https://github.com/Miodec), [Discord](https://discord.gg/monkeytype) in the `#development` channel, or ask a question on Monkeytype's [GitHub discussions](https://github.com/monkeytypegame/monkeytype/discussions) and a contributor will be happy to assist you.