Release lifecycle docs overhaul & simplification

README.md

@@ -41,7 +41,7 @@ If this is the first time you're contributing, follow these steps:
 
 ### Use GitHub PR labels
 
-GitHub PR labels are used to track the lifecycle and status of a pull request. Using the correct labels helps with managing workflows and ensuring that content is edited, merged and released at the correct time. For example, PRs that include an **Editor Review** label will be processed by an editor on the writing team to ensure the documentation is correctly formatted at https://docs.mattermost.com/ based on guidelines outlined in the style guide.
+GitHub PR labels are used to track the life cycle and status of a pull request. Using the correct labels helps with managing workflows and ensuring that content is edited, merged and released at the correct time. For example, PRs that include an **Editor Review** label will be processed by an editor on the writing team to ensure the documentation is correctly formatted at https://docs.mattermost.com/ based on guidelines outlined in the style guide.
 
 Take a look at the [Labels](https://developers.mattermost.com/contribute/getting-started/labels/) page for information about how and when to use which labels.
 

source/_static/badges/allplans-cloud-selfhosted.md

@@ -0,0 +1,11 @@
+```{raw} html
+<div class="mm-plans-badge">
+```
+
+![plans-img](../_static/images/badges/flag_icon.svg) Available on [all plans](https://mattermost.com/pricing/)
+
+![deployment-img](../_static/images/badges/deployment_icon.svg) [Cloud](https://mattermost.com/sign-up/) and [self-hosted](https://mattermost.com/deploy/) deployments
+
+```{raw} html
+</div>
+```

source/_static/badges/allplans-selfhosted.md

@@ -0,0 +1,11 @@
+```{raw} html
+<div class="mm-plans-badge">
+```
+
+![plans-img](../_static/images/badges/flag_icon.svg) Available on [all plans](https://mattermost.com/pricing/)
+
+![deployment-img](../_static/images/badges/deployment_icon.svg) [self-hosted](https://mattermost.com/deploy/) deployments
+
+```{raw} html
+</div>
+```

source/_static/badges/ent-only.md

@@ -0,0 +1,12 @@
+```{raw} html
+<div class="mm-plans-badge">
+```
+
+![plans-img](../_static/images/badges/flag_icon.svg) Available only on [Enterprise](https://mattermost.com/pricing/) plans
+
+```{raw} html
+</div>
+```
+
+
+

source/_static/badges/selfhosted-only.md

@@ -0,0 +1,11 @@
+```{raw} html
+<div class="mm-badge mm-badge--note">
+```
+
+Note
+
+![deployment-img-yellow](../_static/images/badges/deployment_icon_yellow.svg) Available only for `self-hosted <https://mattermost.com/deploy/>`_ deployments
+
+```{raw} html
+</div>
+```

source/deploy/deprecated-features.rst → source/about/deprecated-features.rst

@@ -1,5 +1,5 @@
-Removed and deprecated features for Mattermost
-==============================================
+Removed and deprecated features
+===============================
 
 This page describes features that are removed from support for Mattermost, or will be removed in a future update (deprecated), and provides early notice about future changes that might affect your use of Mattermost. This information is subject to change with future releases, and might not include each deprecated feature.
 
@@ -116,7 +116,7 @@ Mattermost Server v5.0.0
 Mattermost Server v4.9.0
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-- A number of permissions configuration settings will be migrated to roles in the database, and changing their config.json values will no longer take effect. These permissions can still be modified by their respective System Console settings. See :doc:`changelog </deploy/legacy-self-hosted-changelog>` for more details.
+- A number of permissions configuration settings will be migrated to roles in the database, and changing their config.json values will no longer take effect. These permissions can still be modified by their respective System Console settings. See :doc:`changelog </about/unsupported-legacy-releases>` for more details.
 
 Mattermost Server v4.0.0
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

source/about/desktop.rst

@@ -0,0 +1,22 @@
+Desktop
+========
+
+.. include:: ../_static/badges/allplans-cloud-selfhosted.rst
+  :start-after: :nosearch:
+
+The Mattermost desktop app is available for Linux, Mac, and Windows operating systems. The Desktop App supports all the features of the web experience, and enable users to :doc:`connect to multiple Mattermost servers </preferences/connect-multiple-workspaces>` from a single interface, navigate between servers using keyboard shortcuts, and :doc:`customize their desktop user experience </preferences/customize-desktop-app-experience>`.
+
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+   :titlesonly:
+
+   /about/mattermost-desktop-releases.md
+   /about/desktop-app-changelog.md
+
+Learn more about:
+
+* :doc:`Desktop releases </about/mattermost-desktop-releases>`
+* :doc:`Desktop changelog </about/desktop-app-changelog>`
+
+See the :ref:`desktop app software requirements <install/software-hardware-requirements:desktop apps>` for details on supported operating systems and releases.

source/about/editions-and-offerings.rst

@@ -1,5 +1,5 @@
-Mattermost editions and offerings 
-=================================
+Editions and offerings 
+======================
 
 Mattermost is an open core platform. 
 

source/about/faq-general.rst

@@ -32,7 +32,7 @@ The open source Mattermost Team Edition is functionally identical to the commerc
 
 We generally recommend installing Enterprise Edition, even if you don't currently need a license. This provides the flexibility to unlock Enterprise features seamlessly should you need them. However, if you only want to install software with a fully open source code base, then Team Edition is the best choice for you.
 
-To deploy the Team Edition, download the :ref:`Mattermost Team Edition binary <upgrade/version-archive:mattermost team edition>`, and follow our standard install guides. The same applies to server upgrades.
+To deploy the Team Edition, download the :doc:`Mattermost Team Edition binary </about/version-archive>`, and follow our standard install guides. The same applies to server upgrades.
 
 What are the limitations for embargoed countries?
 -------------------------------------------------

source/about/mattermost-desktop-releases.md

@@ -0,0 +1,33 @@
+# Desktop releases
+
+```{include} ../_static/badges/allplans-cloud-selfhosted.md
+```
+
+```{Important}
+ Support for Mattermost Server v8.1 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle in May 15, 2024. Upgrading to Mattermost Server v9.5 or later is required.
+```
+
+## Frequency
+
+Mattermost releases a new desktop app version every 4 months, in February, May, August, and November in [binary form](https://docs.mattermost.com/collaborate/install-desktop-app.html#install-and-update-the-mattermost-desktop-app). See the [Desktop app changelog](/about/desktop-app-changelog) for release details.
+
+
+```{Important}
+- From Mattermost v9.11, Mattermost server extended releases are now paired with Mattermost desktop app extended releases. For an optimal user experience and for the latest security fixes, we strongly recommend updating desktop clients to the latest version your Mattermost server supports. See the table below for server compatibility, and see the [Mattermost extended support releases](#extended-support-releases) documentation to learn more about extended releases.
+- If you prefer to control the server and client releases, we recommend disabling automatic client updates to prevent users from upgrading their desktop client to a version your server doesn't support. See the [install Mattermost desktop app](/collaborate/install-desktop-app) documentation for platform-specific details on automatic app updates.
+```
+
+## Latest releases
+
+| **Release** | **Released on** | **Support ends** | **Compatible with** |
+|:---|:---|:---|:---|
+| v5.8 [Download](https://github.com/mattermost/desktop/releases/tag/v5.8.0) \| {ref}`Changelog <release-v5-8>` | 2024-05-16 | 2024-08-15 | {ref}`v9.9 <release-v9-9-feature-release>`, {ref}`v9.8 <release-v9-8-feature-release>`, {ref}`v9.7 <release-v9-7-feature-release>`, {ref}`v9.6 <release-v9-6-feature-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>`, {ref}`v8.1 <release-v8-1-extended-support-release>` |
+| v5.7 [Download](https://github.com/mattermost/desktop/releases/tag/v5.7.0) \| {ref}`Changelog <release-v5-7>` | 2024-03-15 | 2024-05-15 | {ref}`v9.6 <release-v9-6-feature-release>` |
+| v5.6 [Download](https://github.com/mattermost/desktop/releases/tag/v5.6.0) \| {ref}`Changelog <release-v5-6>` | 2023-12-15 | 2024-03-14 | {ref}`v9.3 <release-v9-3-feature-release>` |
+| v5.5 [Download](https://github.com/mattermost/desktop/releases/tag/v5.5.1) \| {ref}`Changelog <release-v5-5>` | 2023-09-15 | 2023-12-14 | {ref}`v9.0 <release-v9-0-major-release>` |
+| v5.4 [Download](https://github.com/mattermost/desktop/releases/tag/v5.4.0) \| {ref}`Changelog <release-v5-4>` | 2023-06-19 | 2023-09-14 | {ref}`v7.10 <release-v7-10-feature-release>` |
+| v5.3 [Download](https://github.com/mattermost/desktop/releases/tag/v5.3.1) \| {ref}`Changelog <release-v5-3>` | 2023-03-30 | 2023-06-18 | {ref}`v7.9 <release-v7-9-feature-release>` |
+| v5.2 [Download](https://github.com/mattermost/desktop/releases/tag/v5.2.2) \| {ref}`Changelog <release-v5-2>` | 2022-10-31 | 2023-03-29 | {ref}`v7.4 <release-v7-4-feature-release>` |
+| v5.1 [Download](https://github.com/mattermost/desktop/releases/tag/v5.1.1) \| {ref}`Changelog <release-v5-1>` | 2022-05-16 | 2022-10-30 | {ref}`v6.7 <release-v6-7-feature-release>` |
+| v5.0 [Download](https://github.com/mattermost/desktop/releases/tag/v5.0.4) \| {ref}`Changelog <release-v5-0>` | 2021-10-13 | 2022-05-15 | {ref}`v6.0 <release-v6-0-feature-release>` |
+|  |  |  |  |

source/about/mattermost-mobile-releases.md

@@ -0,0 +1,39 @@
+# Mobile releases
+
+```{include} ../_static/badges/allplans-cloud-selfhosted.md
+```
+
+```{Important}
+- Support for Mattermost Server v8.1 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle in May 15, 2024. Upgrading to Mattermost Server v9.5 or later is required.
+- We strongly recommend using the latest mobile app release available that contains the latest security fixes and user experience enhancements. Mobile app releases are tested against all generally available Mattermost server and extended support releases.
+```
+
+## Frequency
+
+Mattermost releases a new mobile app version every month. Mattermost tests the latest mobile app release against the [latest server version](/about/mattermost-server-releases).
+
+See the [Mobile app changelog](/about/mobile-app-changelog) for release details, and see the [iOS mobile app](/collaborate/install-ios-app) and the [Android mobile app](/collaborate/install-android-app) documentation for installation details. 
+
+## Latest releases
+
+| **Release** | **Released on** | **Support ends** | **Compatible with** |
+|:---|:---|:---|:---|
+| v2.17 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.17.1) \| {ref}`Changelog <release-v2-17-1>` | 2024-06-16 | 2024-07-15 | {ref}`v9.9 <release-v9-9-feature-release>` |
+| v2.16 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.16.0) \| {ref}`Changelog <release-v2-16-0>` | 2024-05-16 | 2024-06-15 | {ref}`v9.8 <release-v9-8-feature-release>` |
+| v2.15 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.15.0) \| {ref}`Changelog <release-v2-15-0>` | 2024-04-16 | 2024-05-15 | {ref}`v9.7 <release-v9-7-feature-release>` |
+| v2.14 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.14.0) \| {ref}`Changelog <release-v2-14-0>` | 2024-03-15 | 2024-04-15 | {ref}`v9.6 <release-v9-6-feature-release>` |
+| v2.13 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.13.0) \| {ref}`Changelog <release-v2-13-0>` | 2024-02-16 | 2024-03-14 | {ref}`v9.5 <release-v9-5-extended-support-release>` |
+| v2.12 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.12.2) \| {ref}`Changelog <release-v2-12-0>` | 2024-01-16 | 2024-02-15 | {ref}`v9.4 <release-v9-4-feature-release>` |
+| v2.11 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.11.0) \| {ref}`Changelog <release-v2-11-0>` | 2023-12-16 | 2024-01-15 | {ref}`v9.3 <release-v9-3-feature-release>` |
+| v2.10 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.10.1) \| {ref}`Changelog <release-v2-10-0>` | 2023-11-16 | 2023-12-15 | {ref}`v9.2 <release-v9-2-feature-release>` |
+| v2.9 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.9.1) \| {ref}`Changelog <release-v2-9-0>` | 2023-10-16 | 2023-11-15 | {ref}`v9.1 <release-v9-1-feature-release>` |
+| v2.8 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.8.2) \| {ref}`Changelog <release-v2-8-0>` | 2023-09-15 | 2023-10-15 | {ref}`v9.0 <release-v9-0-major-release>` |
+| v2.7 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.7.0) \| {ref}`Changelog <release-v2-7-0>` | 2023-08-16 | 2023-09-14 | {ref}`v8.1 <release-v8-1-extended-support-release>` |
+| v2.6 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.6.0) \| {ref}`Changelog <release-v2-6-0>` | 2023-07-16 | 2023-08-15 | {ref}`v8.0 <release-v8-0-major-release>` |
+| v2.5 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.5.1) \| {ref}`Changelog <release-v2-5-0>` | 2023-06-16 | 2023-07-15 | {ref}`v7.10 <release-v7-10-feature-release>` |
+| v2.4 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.4.0) \| {ref}`Changelog <release-v2-4-0>` | 2023-05-17 | 2023-06-15 | {ref}`v7.10 <release-v7-10-feature-release>` |
+| v2.3 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.3.0) \| {ref}`Changelog <release-v2-3-0>` | 2023-04-16 | 2023-05-16 | {ref}`v7.10 <release-v7-10-feature-release>` |
+| v2.2 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.2.0) \| {ref}`Changelog <release-v2-2-0>` | 2023-03-17 | 2023-04-15 | {ref}`v7.9 <release-v7-9-feature-release>` |
+| v2.1 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.1.0) \| {ref}`Changelog <release-v2-1-0>` | 2023-02-16 | 2023-03-16 | {ref}`v7.8 <release-v7-8-extended-support-release>` |
+| v2.0 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/desktop/releases/tag/v2.0.1) \| {ref}`Changelog <release-v2-0-0>` | 2023-01-16 | 2023-02-15 | {ref}`v7.7 <release-v7-7-feature-release>` |
+|  |  |  |  |

source/about/mattermost-server-releases.md

@@ -0,0 +1,31 @@
+(mattermost-server-releases)=
+# Server releases
+
+```{include} ../_static/badges/allplans-selfhosted.md
+```
+
+```{Important}
+ Support for Mattermost Server v8.1 [Extended Support Release](https://docs.mattermost.com/about/release-policy.html#extended-support-releases) has come to the end of its life cycle in May 15, 2024. Upgrading to Mattermost Server v9.5 or later is required.
+```
+
+## Frequency
+Mattermost releases a new server version on the 16th of each month in [binary form](/upgrade/upgrading-mattermost-server). 
+- See the [v10 changelog](/about/mattermost-v10-changelog) for details on what's coming and changing in the next major release. 
+- See the [v9 changelog](/about/mattermost-v9-changelog) for details on v9.x server releases.
+- See the [unsupported Mattermost legacy releases](/about/unsupported-legacy-releases) documentation for details on older, unsupported  Mattermost releases.
+
+## Latest releases
+
+| **Release** | **Released on** | **Support ends** |
+|:---|:---|:---|
+| v9.9 [Download](https://releases.mattermost.com/9.9.0/mattermost-9.9.0-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-9-feature-release>` | 2024-06-14 | 2024-09-15 |
+| v9.8 [Download](https://releases.mattermost.com/9.8.1/mattermost-9.8.1-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-8-feature-release>` | 2024-05-16 | 2024-08-15 |
+| v9.7 [Download](https://releases.mattermost.com/9.7.5/mattermost-9.7.5-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-7-feature-release>` | 2024-04-16 | 2024-07-15 |
+| v9.6 [Download](https://releases.mattermost.com/9.6.3/mattermost-9.6.3-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-6-feature-release>` | 2024-03-16 | 2024-06-15 |
+| v9.5 [Download](https://releases.mattermost.com/9.5.6/mattermost-9.5.6-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-5-extended-support-release>` | 2024-02-16 | 2024-11-15 {ref}`EXTENDED <release-types>` |
+| v9.4 [Download](https://releases.mattermost.com/9.4.5/mattermost-9.4.5-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-4-feature-release>` | 2024-01-16 | 2024-04-15 |
+| v9.3 [Download](https://releases.mattermost.com/9.3.3/mattermost-9.3.3-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-3-feature-release>` | 2023-12-16 | 2024-03-15 |
+| v9.2 [Download](https://releases.mattermost.com/9.2.6/mattermost-9.2.6-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-2-feature-release>` | 2023-11-16 | 2024-02-15 |
+| v9.1 [Download](https://releases.mattermost.com/9.1.5/mattermost-9.1.5-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-1-feature-release>` | 2023-10-16 | 2024-01-15 |
+| v9.0 [Download](https://releases.mattermost.com/9.0.5/mattermost-9.0.5-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-0-major-release>` | 2023-09-16 | 2023-12-15 |
+|  |  |  |

source/about/mattermost-v10-changelog.md

@@ -0,0 +1,22 @@
+# v10 changelog
+
+```{Important}
+Support for Mattermost Server v8.1 [Extended Support Release](https://docs.mattermost.com/deploy/about/release-policy.html#extended-support-releases) has come to the end of its life cycle in May 15, 2024. Upgrading to Mattermost Server v9.5 or later is required.
+- See the [Important Upgrade Notes](/upgrade/important-upgrade-notes.html) documentation for details on upgrading to a newer release.
+- See the [changelog in progress](https://bit.ly/2nK3cVf) for details about the upcoming release.
+```
+
+(release-v10.0-feature-release)=
+## Release v10.0 - Major Release
+
+**Release day: 2024-09-16**
+
+More information on this Mattermost major release coming soon. See the {doc}`Mattermost release policy </about/release-policy>` documentation for details on {ref}`release types <about/release-policy:release types>`.
+
+### Upcoming Breaking Changes in v10.0 Release
+
+Mattermost v10.0 is planned for September, 2024. Below is a list of planned breaking changes for this release:
+
+1. **MySQL Databases** - We will no longer support new installations using MySQL starting in v10. All new customers and/or deployments will only be supported with the minimum supported version of the PostgreSQL database. End of support for MySQL is targeted for Mattermost v11.
+2. **Apps Framework** - Apps framework will be deprecated in a future upcoming release. Please utilize the plugin framework for developing integrations with the core Mattermost platform.
+3. **Playbooks for Enterprise** - An Enterprise license will be required to use v2.0+ Playbooks functionality starting in v10. Team Edition and Professional deployments can continue to use Playbooks v1.x. Security and feature updates will only be added to Playbooks v2.0+.