Skip to content

Latest commit

 

History

History
49 lines (35 loc) · 1.78 KB

CONTRIBUTING.md

File metadata and controls

49 lines (35 loc) · 1.78 KB

Contributing

Suggestions & Issues

To suggest features for the bot use the GitHub issue tracker.

If you believe to have found a bug in the code and think it's harmless, report it through the GitHub issue tracker.
If you think that this bug might be harmful or exploitable, follow the instructions of the security file.

Pull requests

Contributors are welcome. Feel free to fork and submit a pull request for review.

  1. Fork & clone
  2. Create a new branch
  3. Code away
  4. Test your changes
  5. Commit & push
  6. Submit the pull request
  7. Act according to reviews

Guidelines

To make sure that your pull request gets accepted you need to follow some guidelines.
This is not everything but a list of basic things. Think before you do.

  • Follow to modular style of the project
  • Follow "best practices" for javascript which are enforced by eslint
  • Write understandable code
  • Make features easy to use
  • Make bugfixes simple and effective

Running the bot

Production

Either download or build the docker image and run it with docker-compose or docker.
Available environmental variables listed in the .env.example file in project root.
Mount /app/data as a volume. Example docker-compose.yml can be found in the project root.

Development

  1. Install Node.JS and Yarn if don't have them already
  2. Create an application at Discord Developer Portal
  3. Create a bot for the application
  4. Copy the bot's token and enable the server members intent
  5. Fill in .env with the help of .env.example or use a file provided by another contributor
  6. Install dependencies with yarn
  7. Run with yarn start