snapshot of https://github.com/mattermost/mattermost.git (master, 2026-09-16; blobs > 131072B omitted)

docs/styles/Mattermost/BrandVoice.yml

@@ -0,0 +1,19 @@
+extends: existence
+message: "Brand voice: avoid '%s' in normative content. Mattermost is mission-critical, not casual."
+level: warning
+ignorecase: true
+# Brand pillars: Focused, Adaptable, Secure, Resilient.
+# Tone: 'Built for the War Room. Not the Break Room.'
+# Banned casual phrasing in normative documentation. Acceptable in blog/marketing.
+tokens:
+  - "easy peasy"
+  - "super easy"
+  - "no worries"
+  - "just kidding"
+  - "fun"
+  - "awesome"
+  - "cool"
+  - "yay"
+  - "let's go!"
+  - "magic"
+  - "magical"

docs/styles/Mattermost/Headings.yml

@@ -0,0 +1,43 @@
+extends: capitalization
+message: "Use sentence case for '%s' (capitalize only the first word and proper nouns)."
+level: warning
+match: $sentence
+scope: heading
+indicators:
+  - ":"
+exceptions:
+  - Mattermost
+  - Channels
+  - Playbooks
+  - Boards
+  - Copilot
+  - Calls
+  - GitHub
+  - GitLab
+  - Kubernetes
+  - PostgreSQL
+  - MySQL
+  - LDAP
+  - SAML
+  - OAuth
+  - API
+  - APIs
+  - REST
+  - JSON
+  - YAML
+  - SSH
+  - TLS
+  - HTTP
+  - HTTPS
+  - URL
+  - URLs
+  - WebSocket
+  - WebSockets
+  - Markdown
+  - Cloud
+  - Server
+  - Enterprise
+  - Free
+  - Professional
+  - Zero Trust
+  - Mission in Motion

docs/styles/Mattermost/SentenceLength.yml

@@ -0,0 +1,6 @@
+extends: occurrence
+message: "Sentence is %s words; consider breaking it up. Mission-critical content reads short."
+level: suggestion
+scope: sentence
+max: 35
+token: \b(\w+)\b

docs/styles/Mattermost/Terminology.yml

@@ -0,0 +1,50 @@
+extends: substitution
+message: "Use '%s' instead of '%s'."
+level: warning
+ignorecase: true
+# Mattermost product terminology. Codifies handbook style guide.
+# See: https://handbook.mattermost.com/operations/research-and-development/product/technical-writing-team-handbook/documentation-style-guide
+swap:
+  # Product names
+  matter most: Mattermost
+  matter-most: Mattermost
+  mattermost cloud: Mattermost Cloud
+  mattermost server: Mattermost Server
+  mattermost team edition: Mattermost Team Edition
+  mattermost enterprise edition: Mattermost Enterprise Edition
+
+  # Feature names — proper-cased per brand
+  channels: Channels
+  playbooks: Playbooks
+  boards: Boards
+  copilot: Copilot
+  calls: Calls
+
+  # Audience naming
+  e-mail: email
+  e mail: email
+  log-in: log in
+  login (verb): log in
+  log-out: log out
+  logout (verb): log out
+  sign-in: sign in
+  sign-out: sign out
+
+  # Common technical terminology
+  github: GitHub
+  gitlab: GitLab
+  kubernetes: Kubernetes
+  postgres: PostgreSQL
+  mysql: MySQL
+  ldap: LDAP
+  saml: SAML
+  oauth: OAuth
+  api: API
+  apis: APIs
+  url: URL
+  urls: URLs
+  json: JSON
+  yaml: YAML
+  ssh: SSH
+  tls: TLS
+  ssl: TLS                            # Mattermost docs prefer TLS over SSL