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
  • Screenshot Development of Mattermost User Interface
  • Setup tips
  • Checklist
  • Sharing a screenshot
  • Recording a GIF
  • Do's and Don'ts

Was this helpful?

Edit on Git
Export as PDF
  1. Operations
  2. Messaging and Math
  3. How-to guides for M&M

How to create screenshots and GIFs

50% draft

PreviousHow to create release announcementsNextHow to write Mattermost case studies

Last updated 3 years ago

Was this helpful?

Screenshot Development of Mattermost User Interface

The purpose is to highlight and illustrate the best features of Mattermost user interface.

When choosing what to highlight in the screenshot, follow this order:

  1. An end-user screenshot that best illustrates the feature.

  2. Screenshot of System Console or other settings help text.

  3. Screenshot of documentation.

  4. Screenshot of a code mentioning the feature and/or Mattermost.

Setup tips

  • Use the Mattermost Desktop App, which has a nicer border.

  • Create a secondary account with [first.last]+blah@mattermost.com email address. This makes triggering notifications for yourself easier (for the screenshot). You can also use a second browser to login to the second account while taking the screenshot.

Checklist

  • Screen size:

    • Size your Mattermost Desktop App or browser to capture a screenshot approximately 900px by 640px, excluding browser navigation.

    • Use default 100% zoom.

    • Tip: Close the right-hand sidebar, and close the team sidebar by leaving all but one team.

  • Font size:

    • All text should have large enough font size so that text is easily readable.

  • Visuals:

    • Profile pictures and real people’s names should be filled out throughout the screenshot.

    • For the profile picture, use either normal-looking Avatars or stock photography from .

    • Select the default "Mattermost" theme color in Account Settings > Theme.

  • Left-hand sidebar:

    • Include Favorite, Public, and Private channels on the left-hand sidebar.

    • Make sure that you scroll all the way to the top in the channel list on the left-hand sidebar for the screenshot.

    • You can have a few unreads or mentions visible, but don't include an “unread posts” indicator in the left-hand sidebar.

  • Favorites channel list: Include the following:

    • One Public channel.

    • One Direct Message channel with someone who is online.

    • One Group Direct Message channel using people with short names to avoid truncation.

  • Center pane:

    • Make the center pane one of the Favorited channels.

    • Make sure that the heading of the center pane is fully visible to avoid truncation.

    • Make the first message in the center pane fully visible right below the channel header.

  • Team list

    • Connect team names to channel names, e.g. Contributors, Developers, Toolkit, etc. to contribute to a broader overall theme and story.

    • E.g. could use icons of different maps, or city skylines, to indicate offices of different teams, or business units of a bank (customer service, security, research, etc.), etc.

  • Clarity:

    • Avoid showing any text with acronyms and abbreviations.

    • Do not show any bugs or defects.

  • Outline:

    • Ensure that the screenshot has a grey (#F7F9FA) outline in all four edges. This helps ensure the screenshot looks good against both dark and light backgrounds.

  • Outstanding look: Ensure that the contents of the screenshot shows the Mattermost product in the best light.

    • Show the feature in action.

    • Make sure that the screenshot is positive - give whoever is viewing it a positive emotion.

    • Show how the feature can be extended and customized. For instance, use custom slash commands instead of the default commands.

Sharing a screenshot

  1. Share the original: Always share the original in .JPG or .PNG format, or pasted in a slide.

    1. If you share screenshots in a slide with a drop shadow or other formatting, make sure the original is provided as a backup in case the user needs a different manipulation.

  2. Share the manipulation (optional): If you're modifying screenshots using a format that can include layer or the original manipulation (e.g. Photoshop), offer the file containing modifications if you can in .PSD or .TIF format.

Recording a GIF

Do's and Don'ts

Don't zoom past 100% and pixelated images

Example of what not to do:

Do show sub-components framed in grey (#F7F9FA) background

Instead, show the sub-component at 100% zoom with a 12pt white border (so there's white space) and a grey (#F7F9FA) background with no border, so the image is neatly framed:

Don't display watermarks and vendor names on screenshots or GIFs

Example of what not to do ("Stop" and "created with gifrecorder.com" overlayed at the end of the GIF):

Don't take a screenshot at high resolution

Text is hard to read when image is reduced for sharing on blog posts, social media and possibly in slides:

Do size Mattermost to capture approximately a 900px by 640px area

This enables sharing the image in documentation, social media, and marketing content more easily.

Use to create GIFs. Ensure there are no watermarks or vendor names overlaying the GIF.

When you need to show a particular part of the product, don't crop the image and zoom past 100% to show the functionality. Screenshots should be full-sized (no zoom-in, no resizing within Google Doc), potentially stored in a .TIF file. For optimal quality on Mac screenshots, .

istockphoto.com
GIF Brewery
see this help article
DO NOT use Zoom level other than 100% for screenshots