d3ed609ab9 docs: fix broken mm-ref:/mm-doc: placeholder links from RST migration (#37673)
* docs: fix broken mm-ref:/mm-doc: placeholder links from RST migration

During the Sphinx/RST-to-Docusaurus/MDX conversion, every RST :ref: and
:doc: cross-reference role was converted into a dead link using a
made-up, non-functional URI scheme (mm-ref:/mm-doc:) instead of a real
path, leaving ~228 broken links across ~20 docs/main files.

Decode each payload and resolve it to a working relative link, computing
the target heading's anchor slug (via github-slugger, matching
Docusaurus's own heading-id algorithm) where the original :ref: pointed
at a specific section. A few links with no confidently matching target
are marked with a TODO comment for follow-up.

* Resolve remaining ESR link TODOs and rebuild mangled version table

The three mm-ref: TODOs left by the previous pass pointed at RST
:ref: labels (release-v9-11-extended-support-release, etc.) that
exist as real headings in unsupported-legacy-releases.mdx and
mattermost-v10-changelog.mdx, not in release-policy.mdx. Resolved
them to the correct anchors.

While fixing the links, also rebuilt the surrounding table: it was
the same blockquote/dl/dt-with-literal-RST-separators artifact seen
elsewhere in the RST-to-MDX migration, plus a phantom 4th table
column. Cross-checked against the legacy RST source
(server-deployment-planning.rst) to confirm it's really 3 columns.

* Fix anchor over-extension and truncated RST fragments in table cells

- authentication-configuration-settings.mdx / site-configuration-
  settings.mdx: the migrated doc links wrapped far more text than
  intended ("multi-factor authentication (MFA) | - System Config
  path: ..." / "threaded discussions | - System Config path: ...").
  Closed the anchor immediately after the link label so the System
  Config path text renders as plain text outside the link, matching
  the pattern used elsewhere in these tables.
- client-availability.mdx: three table cells (Preview image links,
  Join existing team, Create a new team) retained truncated RST
  :ref: label fragments ("ments>`__", "eam>`__", "team>`__") left
  over from the conversion. Removed them - the checkmark cells
  already carry the correct support indicators, cross-checked against
  the legacy RST source table.

* Fix stray absolute doc link and leaked table separators

- important-upgrade-notes.mdx: the first Compliance Export doc link in
  the v10.5 row pointed at the absolute docs.mattermost.com/*.html URL
  instead of the site-relative canonical path (the second link in the
  same cell already used the correct path).
- client-availability.mdx: 15 feature-name links across the Messages,
  Channels, Teams, Playbooks, Calls, Authentication, and Other tables
  had leftover RST table-separator artifacts ("| | | |") bleeding into
  the anchor text. Removed them so the link boundary matches the
  correctly-converted rows elsewhere in the same tables.

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-27 13:26:46 +03:00
2026-07-21 13:10:25 -04:00
2026-04-01 13:03:36 +00:00

Mattermost logo

Mattermost is an open core, self-hosted collaboration platform that offers chat, workflow automation, voice calling, screen sharing, and AI integration. This repo is the primary source for core development on the Mattermost platform; it's written in Go and React, runs as a single Linux binary, and relies on PostgreSQL. A new compiled version is released under an MIT license every month on the 16th.

Deploy Mattermost on-premises, or try it for free in the cloud.

mattermost user interface

Learn more about the following use cases with Mattermost:

Other useful resources:

Table of contents

Install Mattermost

Other install guides:

Native mobile and desktop apps

In addition to the web interface, you can also download Mattermost clients for Android, iOS, Windows PC, macOS, and Linux.

Get Mattermost on Google Play Get Mattermost on the App Store Get Mattermost on Windows PC Get Mattermost on Mac OSX Get Mattermost on Linux

Get security bulletins

Receive notifications of critical security updates. The sophistication of online attackers is perpetually increasing. If you're deploying Mattermost it's highly recommended you subscribe to the Mattermost Security Bulletin mailing list for updates on critical security releases.

Subscribe here

Get involved

Learn more

License

See the LICENSE file for license rights and limitations.

Get the latest news

Contributing

Small Image

Please see CONTRIBUTING.md. Join the Mattermost Contributors server to join community discussions about contributions, development, and more.

S
Description
Hanzo Team — the workspace served at hanzo.team
Readme
3.1 GiB
Languages
TypeScript 49.3%
Go 44.1%
SCSS 2.7%
HTML 2.2%
JavaScript 1.4%
Other 0.2%