Development Process Overview

This document describes the process through which feedback and design discussions flow into community systems, then into tickets, then into pull requests, then into bi-monthly releases based on product purpose.

Purpose

The core offer for users of Mattermost is:

  • All your team communication in one place, searchable and accessible anywhere.

The design is successful if 100% of team members use Mattermost for internal communications, and are largely off of email and proprietary SaaS products that lock-in user data as part of their business model.

See Mattermost scope statement for more details.

Community Systems

Please see Community Systems documentation for how feedback from community constituents is processed into tickets accepting pull requests.

Tickets

Mattermost priorities are managed in Jira tickets, which are created by the core team via feedback from community systems as well as through the planning processes.

Triage

On non-holiday weekdays new tickets are reviewed in a process called “triage”, and assigned a Fix Version of “backlog”, indicating the ticket has enough specificity that it can be assigned to a developer to be completed.

By default, all tickets are created as public unless they contain sensitive information. The triage process reviews them for sufficient specificity. If the ticket is unclear, triage may reassign the ticket back to the original reporter to add more details.

View current issues scheduled for the next triage meeting.

Re-triage

If someone feels an existing ticket should be re-examined, they can add “triage” to the Fix Version and it will be routed to the triage team for review at the next meeting.

Release Planning

Release planning sets the “Fix Version” of tickets to one of the upcoming bi-monthly releases. The Fix Version is an estimate of when a feature might ship, which may change as the planning process continues, until the ticket is scheduled for a Sprint.

Sprint Planning

Tickets to be completed in the upcoming two weeks are organized on Tuesdays, with input from developers, and finalized on Fridays.

Pull Requests

Core Team Weekly Rhythm

Core team work on tickets in the active sprint on a weekly basis, which flow into GitHub Pull Requests.

Each Pull Request needs a minimum of two reviews by other core team developers before it is merged, with possible feedback shared as reviews happen.

Key contributors might also pick up tickets, or through conversations with the core team contribute pull requests as needed.

Community Contributions

Community members following the Contribution Guidelines might also submit pull requests. Pull requests should not disable existing functionality without a Jira ticket, which are opened via the feature ideas process.

Bug Fixes

If you see an obvious bug and want to submit a fix, pull requests following the contribution guidelines are gladly accepted.

Examples:

Tickets Accepting Pull Requests

If you’d like to improve the product beyond bug fixes, you can select from a list of tickets accepting pull requests prepared by the core team.

Tickets labelled “accepting pull requests” are intended to be unambiguous projects that could be reasonably completed by contributors outside the core team and are welcome contributions.

Tickets may have a “mana” value assigned, which is an estimate of the relative complexity of each ticket (2 is “small”, “4” is medium, “8” is large).

Even if the ticket is assigned to someone else, so long as the ticket has Status set to Open and the ticket is not in the Active Sprint, contributors following the contribution guidelines are welcome to submit pull requests.

For a list of tickets that meet this criteria, please the list of Tickets Accepting Pull Requests.

Documentation Improvements

Improvements to documentation on master is highly welcome.

Please see documentation contribution guidelines for more details.

Examples:

Minor Improvements

Minor improvements without an Accepting Pull Request ticket may be accepted if:

  1. The contribution aligns with product scope
  2. The change is high quality, and does not impose a significant burden for others to test, document and maintain your change.
  3. The change aligns with the fast, obvious, forgiving design principle.

Examples:

Release

Mattermost ships stable releases on the 16th of the month. Releases begin with a planning process reviewing internal designs and community feedback in the context of the product purpose. Feature development is done in weekly sprints, and releases end with feature complete, stabilization, code complete and release candidate milestones prior to final release.

See release process documentation for more details.