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
  • Goal
  • Expectations
  • Can you help respond to this?
  • General guidelines
  • Community Forums
  • Twitter
  • LinkedIn
  • YouTube
  • HackerNews
  • GitHub
  • Discourse
  • Reddit
  • StackOverflow
  • How do I report inappropriate content in Mattermost community sites?

Was this helpful?

Edit on Git
Export as PDF
  1. Contributors
  2. Contributors
  3. Guidelines and playbooks

Social engagement guidelines

PreviousGuidelines and playbooksNextContribution guidelines and code of conduct

Last updated 2 years ago

Was this helpful?

This playbook outlines the processes and practices used to engage with the Mattermost community across social community channels.

Goal

and improve the Mattermost brand by responding to all Mattermost mentions and questions asked online in a timely manner. We want to help members of the community with their questions, but also making sure that the community is heard and that the feedback from the community reaches the rest of the team at Mattermost.

Expectations

The Community Team is responsible for monitoring and responding to mentions across social media. However, mentions will often require input from someone with specific domain knowledge to ensure we give an accurate response. In these cases, it is expected for subject matter experts within the company to help the community team craft responses.

We understand that everyone is busy, and that these types of requests can often seem like an unnecessary interruption. To mitigate this, the Community Team does the following before asking for assistance:

  1. Search the documentation, Mattermost, the forum, and GitHub issues to see if the question/concern has already been answered.

  2. Redirect the user to more appropriate support channels if the mention seems like it will require in-depth analysis or excessive back-and-forth.

This allows us to respond to the majority of our mentions without help, but there are still times when input from subject matter experts can help us respond much more quickly and accurately.

Can you help respond to this?

We're asking for help responding to this comment so we can ensure we give the best possible answer as quickly as possible. We want to make sure the wider community has the best possible experience when reaching out to us online.

General guidelines

Adopted from

Ultimately, when responding to users you should always keep the Golden Rule in mind -- if you were the person on the other end, how would you want someone to respond to you?

  1. Be professional

    • Maintain professionalism in your responses, as you are speaking as a member of the company. Avoid slang or colloquialisms that may not translate well across other languages.

    • Do not use humor in your responses, as it can be received in the wrong way by the community. Instead, stay factual when answering questions.

  2. Don't answer if unsure

    • Ask someone who knows the answer instead of replying with an assumption or incomplete understanding.

  3. Choose over-communication vs. under-communication

    • Providing as much knowledge, context, and documentation up-front can reduce the number of interactions needed for the conversation to be satisfied.

    • Make reducing frustration a priority; e.g., if you need to ask someone else for an answer and think it might take some time to discuss, inform the user so they can expect a delayed response.

  4. Don't make promises

  5. Choose positivity over negativity

    • Turn a missing feature into an invitation to share a feature idea to be upvoted.

    • Avoid excuses like “we’re busy” or “our team is small."

  6. Do your best to link documentation as answers

    • Links to documentation allow answers to be easily updated dynamically as documentation is updated.

  7. Keep community end-user information secure

    • If you come across a post that includes the person's IP address, domain name, or other information you think should not be disclosed publicly, edit the post to remove this information. Then click the hide revision button so that your edits won't be visible to others on the forum.

  8. Be welcoming and thankful

    • When asking someone to take action, use "Would you be open to..." instead of "Would you like to...".

    • Communities really respond well to being praised and thanked for their work.

Community Forums

Below are guidelines or processes for specific forums we engage with the Mattermost community.

Twitter

Intended outcomes

  1. Likes and loves: Every promoter feels appreciated (like, heart, etc.) and we have acknowledged the best content (re-tweet, quoted re-tweet, mention, shout out, replies, * humor, etc.).

  2. Listening and respond: Everyone with a relevant question gets a reply in 1 business day (except trolls).

  3. Data, learning, and iteration: Understand how we're doing week-to-week, what we've learned, and how we'll up-level our approach.

Workflow

  1. Respond to questions, retweet, and like posts that we are tagged in per the guidelines outlined above.

    • For product inquiries you are uncertain how to answer, you may escalate by at-mentioning @pmteam in the Twitter channel header.

  2. Update posts in the Twitter channel with action taken.

    • React with :heart: if you liked the post.

    • React with :repeat: if you retweeted the post.

    • React with :no_entry_sign: if you took no action.

Response writing tips

  1. Avoid acronyms. Avoid acronyms when possible. For example, say "pull request" instead of "PR", since only a subset of tweet readers are active GitHub users.

  2. Use the active voice. Avoid "has", "was", "have been" when possible. For example, instead of "Hackfest has started!" say "Hackfest starts now!"

  3. Include at most one link. To provide a clear call to action, include at most one link per tweet and place it near the end of the tweet.

  4. Use exclamation marks only for exciting announcements. An exclamation mark can be used when the announcement is exciting, but using an exclamation mark should be avoided when it can be confused with a signal for the community to panic, e.g. "Security update released!".

Sample responses

  1. Asks for more information such as a preview of our product.

    • Thank you for your interest in Mattermost. You can learn more about us at https://mattermost.com where you can also download a trial of our product.

  2. Asks for a specific feature or group of features.

    • Planned feature request: Thank you for your feedback. We're excited to share that [feature] will be available in our [edition] Edition soon. Please see our forum post for more information: [link to forum post].

    • Shipped feature request: Thank you for your feedback. Mattermost already supports [feature]. You can learn more about it in our documentation: [link to docs].

  3. Feedback about their experience, not specific to a feature or a product.

  4. Tweet of forum post, asking someone from Mattermost team to respond.

    • Thank you for reaching out. Our team responded to you in the forums and we're happy to help with further questions there. or

    • Thank you for reaching out. Our team monitors and responds to forum inquiries. We're happy to help with further questions there.

  5. Customer asking for help to address an issue they are having with a deployment or specific feature in the system.

What do we retweet?

  1. Pictures of swag

    • If there’s a lot of swag posts at once (e.g., socks), be careful not to retweet all of them to clutter our timeline.

    • Try to retweet an assortment of different swag types.

  2. Announcements about new plugins from the community

  3. Industry reports that mention Mattermost

    • E.g., “Best collaboration software for 2021”

  4. Third-party content about using Mattermost

    • E.g., “Mattermost Recipes” not written by Mattermost.

  5. Announcements about upcoming events we will be attending

  6. Pro-Mattermost posts from team/community members.

LinkedIn

To be added.

YouTube

To be added.

HackerNews

To be added.

GitHub

To be added.

Discourse

To be added.

Reddit

To be added.

StackOverflow

To be added.

How do I report inappropriate content in Mattermost community sites?

Content in any community site managed by Mattermost should follow the guidelines above. Content that is deemed to be controversial, offensive, potentially defamatory or infringing content from material distributed, broadcast, or posted on websites will be edited or removed.

We ask the community's help in reporting any such content to community@mattermost.com.

Don't be afraid to reroute if you don't have the answer and are having trouble figuring it out. A good place to start is the .

Avoid saying “we’ll work on it” or something similar that sets expectations that aren’t met later. Instead, direct them to our or if applicable.

Any questions that should be answered in docs that aren’t should turn into (with a link to the ticket included in the response).

Monitor and .

Multiple feature requests: Thank you for the suggestions @username. Would you be open to contributing them in the feature idea forum so they can reviewed by our Product Management team? We use the collective feedback of our users to influence the future of the project.

Single feature request: Thank you for the suggestion @username. Would you be open to contributing it in the feature idea forum so it can reviewed by our Product Management team? We use the collective feedback of our users to influence the future of the project.

Appreciate the feedback. If your team has suggestions on how to improve Mattermost, we'd love to hear more in our feature proposal forum. Would you be open to contributing them in the feature idea forum so they can reviewed by our Product Management team? We use the collective feedback of our users to influence the future of the project.

Thanks @{username}, highly appreciate your feedback. If you have additional feedback about your experience, we'd love to hear. You can share at to start a discussion.

Thank you for reaching out. We recommend opening a support ticket where our team can best help you troubleshoot the issue. For more information about Enterprise Edition support levels, see .

Earn trust
https://handbook.mattermost.com/contributors/contributors/community-playbook#response-writing-tips
Mattermost peer-to-peer help channel
Feature Proposal Page
Bug Filing Page
tickets to create that documentation
Twitter channel in Mattermost Contributors Team
this search query
What Matters to You Portal
What Matters to You Portal
What Matters to You Portal
https://forum.mattermost.com)
https://mattermost.com/support/