Mattermost Handbook
Need help?How to spend company moneyHow to update the HandbookRelease overview
0.2.1
0.2.1
  • Mattermost Handbook
  • Company
    • About Mattermost
      • List of terms
      • Business model
      • Mindsets
    • "How to" guides for staff
      • How to set up a 1-1 channel
      • How to update the handbook
      • How to manage Handbook notifications
      • How to change mobile device
        • How to handle a lost mobile device
      • How to do a mini-retrospective
      • How to autolink keywords in Mattermost
  • Operations
    • Company operations
      • Areas of Responsibility
      • Mattermost Leadership Team (MLT)
        • MLT cadence
      • Company measures
        • Metrics definitions
        • FY23 goals board
        • MLT metrics
      • Company cadence
      • Company policies
        • Community response policy
        • Security policy
      • Company processes
        • Issue/solution process
        • Company agreements
        • Publishing
          • Public web properties
          • Publishing guidelines
            • Brand and visual design guidelines
            • Voice, tone, and writing style guidelines
              • Contribute to documentation
            • Confidentiality guidelines
          • Post-publication quality control process
      • Handbook processes and policies
        • Handbook onboarding
      • Fiscal year planning
    • Research and Development
      • Organization
        • Tech Writing
        • Data engineering
        • Delivery
        • Cloud Platform
        • Site Reliability Engineering
        • GRC
        • Product Security
        • Security Operations
      • Processes
        • Feature Labels
      • Product
        • Product planning
          • Product philosophy and principles
          • Prioritization process
          • Release planning process
          • Roadmap views
          • Release plan
          • Launch plan
          • Feature requests
        • Development process
          • Mobile feature guidelines
          • Deprecation policy
          • Mattermost software requirements process
          • Jira ticket lifecycle
          • Creating new Jira bug tickets
            • Priority levels for tickets
            • Jira fix versions
        • Release process
          • Release overview
          • Feature release process
          • Dot release process
          • Security release process
          • Mobile app release process
          • Desktop app release process
          • Release tips
          • Release scorecard definitions
        • How-to guides for Product
          • How to use productboard
          • How to record a roadmap video
          • How to update integrations directory
          • How to write a feature release announcement
        • Product Management team handbook
          • Product Management Areas of Ownership
          • Product Manager onboarding
          • Product Manager levels
          • Professional development
        • Product Design team handbook
          • Product Design levels
        • Technical Writing team handbook
          • Work with us
          • User interface text guidelines
          • Documentation style guide
          • Our terminology
          • Guidelines for PMs and developers
          • Guidelines for community contributions
          • Technical Writer levels
          • Docathon 2021
            • Getting started with contributing
        • Growth
          • A/B testing methodology
          • PQL definition
        • Analytics
          • Product Analyst Engineer levels
          • Looker
            • Dashboards
            • Explores
          • Telemetry
        • Developer relations
        • Product team hangouts
      • Engineering
        • Infrastructure engineering
          • Cloud infrastructure cost KPIs
          • Cloud data export process
          • Cloud churn process
          • Reliability Manifesto
          • Production Readiness Review
          • Infrastructure Library
        • Integrations team processes
        • Plugin release process
        • Data Engineering
        • Sustained Engineering
          • On call
        • How to go to a conference
        • Public speaking
        • Core contributor expanded access policy
      • Quality Assurance
        • QA workflow
        • QA testing tips and tools
        • Rainforest process
    • Messaging and Math
      • How-to guides for M&M
        • How to create release announcements
        • How to create screenshots and GIFs
        • How to write Mattermost case studies
        • How to write guest blog posts for Mattermost apps and services
        • How to write Mattermost recipes
        • How to compose tweets
        • How to create a split test for web page
        • How to run meetups
        • How to run executive dinners
      • Checklists for M&M
        • Blog post checklist
        • Bio checklist
      • Mattermost websites
      • Demand generation reporting
      • M&M Asana guidelines
      • Content marketing
        • How to use the editorial calendar
        • Content development and distribution
        • Video content guidelines
        • How to contribute content
    • Sales
      • Deal Desk
      • Partner programs
      • Lead management
    • Deployment Engineering
      • Overview
      • Workflows
      • Frequently Asked Questions
      • Playbook for MME Sev 1 Outages
      • Status Update Template
    • Program Management
    • Customer Success
      • Customer Support
    • Legal
      • Contracts
      • Ironclad Basics
        • Company-Wide Workflows
        • Sales Contracts and Workflows
        • Signing a Contract and Contract Repository
    • Finance
      • Budget
      • How to use Airbase
        • Access Airbase
        • Navigate Airbase
        • How to submit a purchase request
        • How to submit a reimbursement request
        • How to review a reimbursement request
        • Vendor portal guide
        • Frequently asked questions
      • Onboarding
        • Vendor onboarding
        • ROW staff onboarding
      • Staff member expenses
        • How to spend company money
        • How to spend company money: Internships
        • Corporate credit card policy
        • How to access Airbase
        • Gifting policy
        • How to book airfare and travel
        • How to reimburse the company
        • How to convert currencies
        • How to get paid
      • Arrange a Bounty Program
      • Naming files and agreements
      • Risk management
        • Mattermost U.S. consulting agreements
      • Operations playbook
    • Security
      • Policies
      • Privacy
        • Data deletion requests
        • Data subject access requests
      • Product Security
        • Product Vulnerability Process
        • Working on security-sensitive pull requests
        • Secure Software Development guide
      • Security Operations
        • User guides
    • Workplace
      • PeopleOps
        • HR cadences
        • HR systems
        • HR Processes
        • Working at Mattermost
          • Onboarding
            • Things everyone must know
            • Staff onboarding
            • Engineer onboarding timeline and expectations
            • Manager onboarding
            • Frequently asked questions
          • Learning and development
          • Mattermost communication best practices
          • Paid time off
            • Out of office email example
          • Travel
            • Business travel insurance
          • Leaves of absence
            • Pregnancy leave
            • Baby bonding parental leave
            • Jury duty
          • Workplace program
          • Relocation
          • Total rewards
        • Performance reviews
          • Formal review process
          • New staff performance review
          • Informal review process
        • Transfers and promotions
        • Offboarding instructions for managers
        • People compliance
      • People policies
      • Groups
        • Staff Resource Groups
      • Approvals and iteration
      • IT
        • IT helpdesk
        • Hardware and software purchases
        • Hardware buy back policy
        • Software systems
  • Contributors
    • Contributors
      • Equity, diversity, and inclusion
      • How to contribute to Mattermost
        • Community Content program
        • Documentation contributions
        • Help Wanted tickets
        • Localization
        • Contribution events
      • Mattermost community
      • Contributor kindness
      • Community systems
      • Guidelines and playbooks
        • Social engagement guidelines
        • Contribution guidelines and code of conduct
        • Mattermost Community playbook
        • How to run a Hackathon
        • Hacktoberfest event organizer guide for Mattermost
    • MatterCon
      • Staff information privacy management
      • Mattermost events code of conduct
      • MatterCon2021
    • Join us
      • Ice-breakers
      • Help Wanted tickets
      • Localization
      • Mattermost GitHub sponsorship
      • Things candidates should know
      • Staff recruiting
      • Recruiting cadences
        • Product Manager hiring process
      • Exec recruiting
        • EA logistics
  • Help and support
    • Contact us
Powered by GitBook
On this page
  • Submitting a blog post quickstart guide
  • Writing for Mattermost
  • Great blog submissions
  • Our content wishlist
  • Need help writing?
  • Posts requiring approval
  • Submitting content
  • Accepted formats
  • Review process
  • Publishing

Was this helpful?

Edit on Git
Export as PDF
  1. Operations
  2. Messaging and Math
  3. Content marketing

How to contribute content

PreviousVideo content guidelinesNextSales

Last updated 3 years ago

Was this helpful?

Been to a conference recently? Worked on something cool? Got something else Mattermost-related you want to post about? Writing a blog post is a great way to share your experience with the community.

Submitting a blog post quickstart guide

  • Write your blog post

  • Submit your draft and any image/video files to the Content team in the

  • Address recommendations for scope and clarity (if applicable)

  • Submit bio and headshot to include in post (first submission only)

  • Share published post on your social channels

Writing for Mattermost

The purpose of the is to help developers learn how they can be more productive and to share how the Mattermost team is solving interesting technology challenges. Our intent is for every piece of content to educate and inspire readers to improve their own productivity, whether they’re troubleshooting individual processes or optimizing workflows for their whole team.

The mission of helping developers be more productive doesn’t mean focus only on productivity tools and tips -- sharing how we solved broader technical problems, interesting tech that we’re excited about, and industry trends and issues are all relevant to the larger goal of helping developers unblock their workflows.

Great blog submissions

  • Are focused on a single, clear topic

  • Cover a new topic or angle that isn’t already part of our content catalog

  • Are written concisely and clearly, and formatted for easy skimming

  • Include images or other visuals that enrich the reading experience (videos, gifs, infographics, charts, etc.)

Our content wishlist

If you’re looking for inspiration, here are a few general types of post that we’re always looking for more of:

Need help writing?

If you’re not a confident writer or don’t have time to draft a complete article, you can still contribute! We have some great copywriters on staff who are here to help you turn your ideas into fully-fledged content. Just ping Ashley Dotterweich to connect with a copywriter.

Posts requiring approval

Note that for some types of posts, additional approval is required before moving forward with the publication process. If the content of your post needs to be reviewed by someone else, please have them review the post before submitting it to the Content Team, and let us know if they will need to approve the final copy before it is published.

Some types of post that may require approval:

  • Posts about security issues

  • Posts about upcoming or new features

  • Posts referencing customer use cases that haven’t previously been published

If you aren’t sure if your post requires approval, let us know!

Submitting content

Accepted formats

  • Google Docs (preferred)

  • Markdown file

Review process

After you’ve submitted your post to the Content team, we’ll review it and get back to you within 3 business days with any feedback or suggestions. Articles may require up to 2 rounds of revisions.

Here are the types of edits and feedback you can expect to receive:

  • Grammar and spelling errors: We check the post for grammatical issues, spelling errors, etc. Generally, there is no follow-up required for these edits.

  • SEO review: Search engine optimization helps ensure that our content is discoverable in search engines and is more visible online. These edits include changes to the title and headings of the post, rephrasing some sentences to include target keywords, and adding backlinks to other content. Generally, there is no follow-up required for these edits.

  • Additional recommendations for scope and clarity: To ensure that every post fulfills our editorial mission statement, we may ask for additional edits with the goal of making your post more accessible and useful to readers. These might include:

    • Reordering sections within the post for flow

    • Splitting a long post into two or more articles

    • Removing sections that don’t support the core topic of the post

    • Adding additional context or detail

You (and any other required approvers) will have a chance to review the final version of your post before it goes live. Remember that our goal isn’t to change your voice and tone, just to make you sound like the best version of yourself!

Publishing

After your post is approved, the Content Team will take care of getting it ready for publication in WordPress and let you know when it is scheduled to be published.

If this is your first time submitting an article to the Mattermost blog, don’t forget to submit a short bio and a headshot so we can include it in the post!

Check out and for examples of well-focused content.

While we don't have a specific content wishlist, we welcome a wide variety of content submissions, especially on techinical topics. If you're not sure if a topic would be appropriate for the Mattermost blog, feel free to ask on .

How we solved a technical problem, e.g.

How we built or designed a feature for our product, e.g.

Best practices (or at least, our practices) for a common workflow or process, e.g.

How to use Mattermost in a unique way, e.g.

When you have a post ready for review, please submit a draft and any image/video files to the Content team on the on the Contributor server. You can upload files to this , or link them directly in the channel.

Mattermost: Content channel
Mattermost blog
this post
this post
~Mattermost: Content
Monitoring Cloud Environments at Scale with Prometheus and Thanos
How Mattermost approaches accessibility for the visually impaired
An Introduction to CI/CD pipeline security
5 workflow automations for Mattermost that we love at n8n
~Mattermost: Content channel
Content Submission folder