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 monthly releases based on product 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 Manifesto for more details.
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.
On non-holiday weekdays new tickets are reviewed in a process called “triage”, and assigned a Fix Version of “unscheduled”, indicating the ticket has enough specificity that it can be assigned to a developer to be completed. If the ticket is a bug, it is assigned the Fix Version for the current release.
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.
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 sets the “Fix Version” of tickets to one of the upcoming 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.
Tickets to be completed in the upcoming week are organized on Tuesdays, with input from developers.
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.
If you see an obvious bug and want to submit a fix, pull requests following the contribution guidelines are gladly accepted.
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.
Help Wanted GitHub issues and Accepting Pull Requests (APR) tickets are intended to be unambiguous projects that could be reasonably completed by contributors outside the core team and are welcome contributions.
It’s okay to submit PRs to fix obvious bugs or add small improvements, but anything that significantly changes behavior or user expectations requires an APR ticket opened by the core team so that the change can be tested, documented and supported.
Improvements to documentation are highly welcome.
Please see documentation contribution guidelines for more details.
Documentation Pull Request Review¶
If you’re assigned to a documentation pull request made by a core contributor and you see any minor grammar or spelling fixes, please make a commit to fix them to save time instead of including them in a review. Note that this should only be done for changes submitted by people familiar with the review process.
Minor improvements without an Accepting Pull Request ticket may be accepted if:
- The contribution aligns with product scope
- The change is high quality, and does not impose a significant burden for others to test, document and maintain your change.
- The change aligns with the fast, obvious, forgiving design principle.
Mattermost ships stable releases on the 16th of every 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.