Skip to content
Mattermost Community and Staff Handbook
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Mattermost Handbook

This repository generates the documentation available at

All documentation is available under the terms of a Creative Commons License.


To generate the HTML files from markdown in the /source directory:

  1. Download repo onto a machine with Python installed
  2. Install pipenv: pip install pipenv
  3. cd into the cloned repository
  4. Install required packages: pipenv install
  5. Build: make html - generates files in /build directory


How to create Pull Requests to edit or create Mattermost documentation (by community members):

  1. Sign the Contributor License Agreement (see instructions in the next section).
  2. On the Mattermost Documentation page that you want to edit, click the GitHub icon on the upper right corner that says "Edit".
  3. Click "Edit this file" (pencil icon).
  4. After making changes, check the "Create a new branch for this commit and start a pull request".
  5. Make sure that the Pull Request has a descriptive title. Add comments to briefly tell others what you have worked on (optional).
  6. Click "Create a Pull Request".

Signing CLA:

Please read the Mattermost Contributor Agreement and sign it (at the bottom of the page), so you can be added to the Mattermost Approved Contributor List.

Additional process for Core Committers for Doc Repo:

These steps are to be followed only in situations of urgency or in situations where it is necessary to check that there aren't any high confidentiality issues. Otherwise the standard approval process should be followed.

  1. “Needs Editor Review” label should be processed after merge.
  2. IMPORTANT: Person conducting editor review needs to have their suggestions merged by author. Do this by mentioning the user name in the GitHub Pull Request.
  3. Check weekly or bi-weekly that there are no “Needs Editor Review” labels on closed Pull Requests.

Installation issues

If you can't install sphinx on MacOS try sudo pip install sphinx sphinx-autobuild sphinx_rtd_theme --ignore-installed six.

You can’t perform that action at this time.