Code Contribution Guidelines

Thank you for your interest in contributing to Mattermost. This guide provides an overview of important information for contributors to know.

Choose a Ticket

Review the list of Good First Contribution tickets listed in Jira.
These projects are intended to be a straight forward first pull requests from new contributors. If you don't find something appropriate for your interests, please see the full list of tickets Accepting Pull Requests.
If you have any questions at all about a ticket, please post to the Contributor Discussion section of the Mattermost forum, or email the Mattermost Developer Mailing list.

Follow developer setup instructions to install Mattermost.
Create a branch with set to the ID of the ticket you're working on, for example PLT-394, using command:

git checkout -b <branch name>

Please review the Mattermost Style Guide prior to making changes.

To keep code clean and well structured, Mattermost uses ESLint to check that pull requests adhere to style guidelines for React. Code will need to follow Mattermost's React style guidelines in order to pass the automated build tests when a pull request is submitted.
Please make sure to thoroughly test your change before submitting a pull request.

Please add yourself to the Mattermost approved contributor list prior to submitting by completing the contributor license agreement.
When you submit your pull request please include the Ticket ID at the beginning of your pull request comment, followed by a colon.

For example, for a ticket ID PLT-394 start your comment with: PLT-394:. See previously closed pull requests for examples.

Once submitted, your pull request will be checked via an automated build process and will be reviewed by the Mattermost core team, who may either accept the PR or follow-up with feedback.
If you've included your mailing address in Step 1, you'll be receiving a Limited Edition Mattermost Mug as a thank you gift after your first pull request has been accepted.