Mattermost Handbook
The Mattermost Handbook is a continual work-in-progress for Mattermost staff (people who are paid to work on our open source software), contributor community, and end user community. We use it to document the processes that underpin our company behind our software. Its purpose is to iteratively increase clarity for Mattermost staff and community co-building the future of our company and our offerings, and provide a single-source of truth.
Some norms you'll see here in the Handbook:
Growing companies are a work-in-progress
It's Day 1 at Mattermost. We're a growing company and growing open source project out to support the massive transformation underway as open source software unlocks the massive potential of people and teams around the world. As an open source company we like to share early. Sharing ideas early gets us feedback sooner, so we can iterate faster, so we can better results.
When a section of the handbook is at less than the 50% draft stage you should see it labeled in the page description with the % draft status. When a section doesn't have a % draft status, assume it's over the 50% draft stage.
We believe this system has two key benefits:
Be more open to feedback and iteration: Having something published publicly can make it seem overly "final". By having pages in our handbook at 1% and 50% we make it easier to go through feedback and iteration cycles.
Engage more non-technical people in the discussion: In the past, we've done reviews largely in GitHub pull requests, which is friendly and familiar for technical team members, but more difficult for others. Sharing 1% and 50% drafts in the public for feedback makes our process more inclusive.
Sharing feedback and updating the handbook
Feedback on this handbook is immensely appreciated. There are two ways you can share your feedback:
Key links and materials
Below is a work-in-progress list of key documents and channels at Mattermost. The symbol *
indicates material internal to Mattermost staff.
Last updated