Mattermost Logo
Edit on GitHub

Contribution Checklist

Thanks for your interest in contributing to Mattermost! Come join our Contributors community channel on the community server, where you can discuss questions with community members and the Mattermost core team.

To help with translations, see the localization process.

Follow this checklist for submitting a pull request (PR):

  1. You’ve signed the Contributor License Agreement, so you can be added to the Mattermost Approved Contributor List.
  1. Your ticket is a Help Wanted GitHub issue for the Mattermost project you’re contributing to.

    • If not, follow the process here.
  2. Your code is thoroughly tested, including appropriate unit tests, end-to-end tests for webapp, and manual testing.

  3. If applicable, user interface strings are included in localization files:

    5.1 In the webapp repository run make i18n-extract to generate the new/updated strings.

  4. The PR is submitted against the Mattermost master branch from your fork.

  5. The PR title begins with the Jira or GitHub Ticket ID (e.g. [MM-394] or [GH-394]) and summary template is filled out.

  6. If your PR adds or changes a RESTful API endpoint, please update the API documentation.

  7. If your PR adds a new plugin API method or hook, please add an example to the Plugin Starter Template.

  8. Your PR includes basic documentation about the change/addition you’re submitting. View our guidelines for more information about submitting documentation and the review process.

Once submitted, the automated build process must pass in order for the PR to be accepted. Any errors or failures need to be addressed in order for the PR to be accepted. Next, the PR goes through code review. To learn about the review process for each project, read the CONTRIBUTING.md file of that GitHub repository.

That’s all! If you have any feedback about this checklist, let us know in the Contributors channel.