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

docs/main/for/administrator.mdx

@@ -0,0 +1,40 @@
+---
+title: "For Administrators"
+description: "Start here if you configure and operate Mattermost for your organization."
+slug: /for/administrator
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For Administrators
+
+You're the workspace or system admin who owns the day-to-day operation of one or more Mattermost workspaces. This page is a curated entry point — every link goes to the canonical guide.
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Admin onboarding checklist', to: '/administration-guide/upgrade/admin-onboarding-tasks', description: 'Authentication, projects, security, backups, monitoring.'},
+  {title: 'Set up SSO', to: '/administration-guide/onboard/sso-saml', description: 'AD/LDAP, SAML, OIDC, Entra ID.'},
+  {title: 'Configure the system', to: '/administration-guide/configure/configuration-settings', description: 'Every config setting, grouped by area.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'Roles and permissions', to: '/administration-guide/manage/admin/user-management', description: 'System, team, channel roles + custom permissions.'},
+  {title: 'Compliance machinery', to: '/administration-guide/comply/compliance-export', description: 'Exports, eDiscovery, Legal Hold, retention.'},
+  {title: 'License management', to: '/administration-guide/upgrade/enterprise-install-upgrade', description: 'Self-hosted Enterprise licensing.'},
+  {title: 'Backup and DR', to: '/deployment-guide/backup-disaster-recovery', description: 'Active/Passive AWS, restore procedures.'},
+  {title: 'Upgrade Mattermost', to: '/administration-guide/upgrade/important-upgrade-notes', description: 'Important upgrade notes by version.'},
+  {title: 'mmctl and CLI', to: '/administration-guide/manage/mmctl-command-line-tool', description: 'Command-line administration for runbooks.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For SREs / platform operators', to: '/for/sre', description: 'Reference architecture, scaling, observability.'},
+  {title: 'For security architects', to: '/for/security-architect', description: 'Compliance frameworks, FIPS, hardening.'},
+  {title: 'For compliance officers', to: '/for/compliance-officer', description: 'Audit evidence, regulatory mappings.'},
+]} />

docs/main/for/air-gapped-operator.mdx

@@ -0,0 +1,42 @@
+---
+title: "For Air-Gapped Operators"
+description: "Start here if you deploy and operate Mattermost in network-isolated enclaves."
+slug: /for/air-gapped-operator
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For Air-Gapped Operators
+
+You deploy and operate Mattermost in network-isolated enclaves — air-gapped classified networks, sovereign-cloud enclaves, DoD IL4/IL5 environments, or tactical edges with DDIL connectivity. This page is a curated entry point — every link goes to the canonical guide.
+
+:::important[No internet egress]
+Every page linked from here works without internet access. Stage artifacts on an operator workstation, transfer across your approved boundary, and operate offline.
+:::
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Air-gapped deployment runbook', to: '/deployment-guide/air-gapped-operations/quick-start-runbook', description: 'High-level steps to deploy Mattermost in an air-gapped enclave.'},
+  {title: 'Bill of Materials and Registry Mirroring', to: '/deployment-guide/air-gapped-operations/mirror-package-repositories', description: 'Internal package mirror + container registry.'},
+  {title: 'FIPS / STIG container builds', to: '/deployment-guide/server/containers/fips-stig', description: 'Deploy the FIPS-compliant, STIG-hardened container image.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'Configure for Air-Gapped Operation', to: '/deployment-guide/air-gapped-operations/disable-phone-home-features', description: 'Server settings that depend on internet access.'},
+  {title: 'CMMC compliance', to: '/security-guide/cmmc-compliance', description: 'CMMC 2.0 Level 2 requirement coverage.'},
+  {title: 'Zero Trust architecture', to: '/security-guide/zero-trust', description: 'Mattermost in a Zero Trust deployment.'},
+  {title: 'Application architecture', to: '/deployment-guide/application-architecture', description: 'Components and topology of a Mattermost deployment.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For SREs / platform operators', to: '/for/sre', description: 'General deployment, scaling, operations.'},
+  {title: 'For security architects', to: '/for/security-architect', description: 'Authorization, control mappings, FIPS posture.'},
+  {title: 'For compliance officers', to: '/for/compliance-officer', description: 'Audit evidence and regulatory mapping.'},
+]} />

docs/main/for/compliance-officer.mdx

@@ -0,0 +1,40 @@
+---
+title: "For Compliance Officers"
+description: "Start here if you collect audit evidence, respond to audits, and map regulatory mandates to Mattermost configuration."
+slug: /for/compliance-officer
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For Compliance Officers and Auditors
+
+You collect audit evidence, respond to audits, and map regulatory mandates to Mattermost configuration. You need step-by-step runbooks for exports + eDiscovery + Legal Hold, plus regulatory framework mappings. This page is a curated entry point — every link goes to the canonical guide.
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Comply (operational)', to: '/administration-guide/comply/compliance-export', description: 'Exports, eDiscovery, Legal Hold, retention.'},
+  {title: 'Security Guide', to: '/security-guide/security-guide-index', description: 'Security controls and CMMC, HIPAA, FINRA coverage.'},
+  {title: 'Audit logging', to: '/administration-guide/manage/logging', description: 'Schema, retention, SIEM integration.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'eDiscovery', to: '/administration-guide/comply/electronic-discovery', description: 'Pull communications for legal review.'},
+  {title: 'Legal Hold', to: '/administration-guide/comply/legal-hold', description: 'Preserve communications during litigation.'},
+  {title: 'Data retention', to: '/administration-guide/comply/data-retention-policy', description: 'Policy-driven retention by team and channel.'},
+  {title: 'FINRA compliance', to: '/security-guide/finra-compliance', description: 'Meet FINRA cybersecurity requirements.'},
+  {title: 'Security Updates', to: '/security-guide/security-updates', description: 'Filter live advisories by version and severity.'},
+  {title: 'Permissions and roles', to: '/administration-guide/manage/admin/user-management', description: 'Verify RBAC + custom permissions match policy.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For security architects', to: '/for/security-architect', description: 'Authorization, attestations, citable specifics.'},
+  {title: 'For administrators', to: '/for/administrator', description: 'Day-to-day operational configuration.'},
+  {title: 'For air-gapped operators', to: '/for/air-gapped-operator', description: 'Deployment in network-isolated enclaves.'},
+]} />

docs/main/for/developer.mdx

@@ -0,0 +1,40 @@
+---
+title: "For Developers and Integrators"
+description: "Start here if you build plugins, use the REST API, or integrate Mattermost with other systems."
+slug: /for/developer
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For Developers and Integrators
+
+You build plugins, hit the REST API, or integrate Mattermost with other systems. This page is a curated entry point — the bulk of the canonical content lives in the Developers tab and the API reference.
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Developers tab', to: '/developers', description: 'Plugin SDK, integrate-and-extend, contribution.'},
+  {title: 'API reference', to: '/api', description: '590 endpoints generated from the OpenAPI spec.', meta: '590 endpoints'},
+  {title: 'Integrations Guide', to: '/integrations-guide/integrations-guide-index', description: 'Plugins, webhooks, slash commands.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'Build a plugin', to: '/developers/integrate/plugins', description: 'Server plugin lifecycle, web app component model.'},
+  {title: 'Incoming webhooks', to: '/developers/integrate/webhooks/incoming', description: 'Post messages into Mattermost from external systems.'},
+  {title: 'Outgoing webhooks', to: '/developers/integrate/webhooks/outgoing', description: 'Trigger external systems from Mattermost events.'},
+  {title: 'Slash commands', to: '/integrations-guide/run-slash-commands', description: 'Custom user-triggered actions in chat.'},
+  {title: 'REST API basics', to: '/integrations-guide/restful-api', description: 'Authentication, rate limits, and client libraries.'},
+  {title: 'Interactive messages', to: '/developers/integrate/plugins/interactive-messages', description: 'Buttons and menus in message attachments.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For administrators', to: '/for/administrator', description: 'Workspace configuration and operation.'},
+  {title: 'For SREs / platform operators', to: '/for/sre', description: 'Deploy, scale, observe.'},
+  {title: 'For end users', to: '/for/end-user', description: 'Use Mattermost day to day.'},
+]} />

docs/main/for/end-user.mdx

@@ -0,0 +1,40 @@
+---
+title: "For End Users"
+description: "Start here if you use Mattermost day to day."
+slug: /for/end-user
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For End Users
+
+You use Mattermost day-to-day to message, collaborate, and get work done. This page is a curated entry point — every link goes to the canonical guide.
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Install the app', to: '/end-user-guide/access/install-desktop-app', description: 'Get Mattermost on your laptop and phone.'},
+  {title: 'Connect to a workspace', to: '/end-user-guide/access/access-your-workspace', description: 'Sign in for the first time and join your team.'},
+  {title: 'Configure notifications', to: '/end-user-guide/preferences/manage-your-notifications', description: 'Get pinged for what matters.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'Send and format messages', to: '/end-user-guide/collaborate/send-messages', description: 'Markdown, code blocks, mentions, attachments.'},
+  {title: 'Organize with threads', to: '/end-user-guide/collaborate/organize-conversations', description: 'Keep parallel conversations untangled.'},
+  {title: 'Calls and screen sharing', to: '/end-user-guide/collaborate/audio-and-screensharing', description: 'Audio, screen share, transcription.'},
+  {title: 'Playbooks', to: '/end-user-guide/workflow-automation/workflow-automation-index', description: 'Checklists, runs, retrospectives.'},
+  {title: 'Boards', to: '/end-user-guide/project-management/project-management-index', description: 'Kanban tasks linked to channels.'},
+  {title: 'Keyboard shortcuts', to: '/end-user-guide/collaborate/keyboard-shortcuts', description: 'Move at the speed of muscle memory.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For administrators', to: '/for/administrator', description: 'You configure and operate Mattermost.'},
+  {title: 'For developers', to: '/for/developer', description: 'You build plugins or use the API.'},
+  {title: 'For security architects', to: '/for/security-architect', description: 'You evaluate Mattermost for regulated environments.'},
+]} />

docs/main/for/security-architect.mdx

@@ -0,0 +1,40 @@
+---
+title: "For Security Architects"
+description: "Start here if you evaluate Mattermost for regulated, classified, or DISC environments."
+slug: /for/security-architect
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For Security Architects and Accreditors
+
+You evaluate Mattermost for use in regulated, classified, or DISC (Defense, Intelligence, Security, Critical Infrastructure) environments. You write SSPs, POA&Ms, and authorization memos. You need citable specifics: CMVP certificates, NIST control mappings, attestation status, audit log schemas. This page is a curated entry point — every link goes to the canonical guide.
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Security Updates', to: '/security-guide/security-updates', description: 'Live advisories with version, severity, and product filters.'},
+  {title: 'Security Guide', to: '/security-guide/security-guide-index', description: 'Encryption, access control, audit logging, and compliance.'},
+  {title: 'Cryptography & FIPS', to: '/deployment-guide/server/containers/fips-stig', description: 'FIPS 140-3 / STIG-hardened container image builds.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'CMMC compliance', to: '/security-guide/cmmc-compliance', description: 'CMMC 2.0 Level 2 requirement coverage.'},
+  {title: 'Zero Trust architecture', to: '/security-guide/zero-trust', description: 'Control mapping against the CISA Zero Trust Maturity Model.'},
+  {title: 'Secure Mattermost', to: '/security-guide/secure-mattermost', description: 'Hardening features and where to configure them.'},
+  {title: 'Encryption at rest', to: '/deployment-guide/encryption-options', description: 'DB + file-storage encryption.'},
+  {title: 'Audit logging', to: '/administration-guide/manage/logging', description: 'Schema, retention, SIEM integration.'},
+  {title: 'Compliance export', to: '/administration-guide/comply/compliance-export', description: 'Export evidence for regulated workloads.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For compliance officers', to: '/for/compliance-officer', description: 'Audit evidence, regulatory mapping.'},
+  {title: 'For air-gapped operators', to: '/for/air-gapped-operator', description: 'Network-isolated enclave deployment.'},
+  {title: 'For administrators', to: '/for/administrator', description: 'Day-to-day workspace administration.'},
+]} />

docs/main/for/sre.mdx

@@ -0,0 +1,40 @@
+---
+title: "For SREs and Platform Operators"
+description: "Start here if you own deploy, scale, observability, and disaster recovery for Mattermost."
+slug: /for/sre
+displayed_sidebar: documentation
+hide_table_of_contents: true
+---
+
+<Eyebrow>Persona landing</Eyebrow>
+
+# For SREs and Platform Operators
+
+You own Mattermost's deployment, scaling, and operations. This page is a curated entry point — every link goes to the canonical guide.
+
+## Start here
+
+<CardGrid columns={3} cards={[
+  {title: 'Size your deployment', to: '/deployment-guide/deployment-architecture', description: 'Pick a scale tier and get an architecture and bill of materials.'},
+  {title: 'Prepare your Mattermost Server environment', to: '/deployment-guide/server/preparations', description: 'Database, file storage, network, reverse proxy, and TLS.'},
+  {title: 'Install on Kubernetes', to: '/deployment-guide/server/deploy-kubernetes', description: 'Mattermost Operator + Helm chart + custom resources.'},
+]} />
+
+## Common tasks
+
+<CardGrid columns={3} cards={[
+  {title: 'High availability', to: '/deployment-guide/server/high-availability-cluster-based-deployment', description: 'Clustering across app, DB, and proxy layers.'},
+  {title: 'Hardware sizing', to: '/deployment-guide/software-hardware-requirements', description: 'CPU, memory, disk, network per scale tier.'},
+  {title: 'Air-gapped deployment overview', to: '/deployment-guide/air-gapped-operations/quick-start-runbook', description: 'Deploy Mattermost in a network-isolated enclave.'},
+  {title: 'Calls operations (RTCD)', to: '/deployment-guide/calls/calls-deployment-guide', description: 'RTCD, Offloader, Calls on Kubernetes, metrics.'},
+  {title: 'Prometheus and Grafana', to: '/administration-guide/scale/deploy-prometheus-grafana-for-performance-monitoring', description: 'Scrape configs, dashboards, alert rules.'},
+  {title: 'Backup and DR', to: '/deployment-guide/backup-disaster-recovery', description: 'Backup strategy, retention, restore drills.'},
+]} />
+
+## Other personas
+
+<CardGrid columns={3} cards={[
+  {title: 'For air-gapped operators', to: '/for/air-gapped-operator', description: 'Network-isolated, sovereign-cloud, tactical-edge.'},
+  {title: 'For administrators', to: '/for/administrator', description: 'Day-to-day workspace administration.'},
+  {title: 'For security architects', to: '/for/security-architect', description: 'Compliance frameworks, FIPS, audit logging.'},
+]} />