Skip to content

Commit

Permalink
Merge branch 'master' into reference-architectures-v2
Browse files Browse the repository at this point in the history
  • Loading branch information
cwarnermm authored Sep 16, 2024
2 parents 4793a58 + d5e63ad commit 6ce29ee
Show file tree
Hide file tree
Showing 54 changed files with 664 additions and 254 deletions.
5 changes: 4 additions & 1 deletion source/about/cloud-dedicated.rst
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,10 @@ Mattermost Cloud Dedicated provides access to :doc:`audit and system logs </mana
Customization
~~~~~~~~~~~~~~

Approved plugins developed and/or tested by Mattermost are supported and available in the `Mattermost Marketplace <https://mattermost.com/marketplace/>`_. See the :ref:`plugins <about/integrations:plugins>` documentation for details on supported plugins in Mattermost Cloud deployments.
Approved plugins developed and/or tested by Mattermost are supported and available in the `Mattermost Cloud Marketplace <https://mattermost.com/marketplace/>`_, including:

.. include:: ./cloud-supported-integrations.rst
:start-after: :nosearch:

Migrate from a self-hosted instance
------------------------------------
Expand Down
7 changes: 6 additions & 1 deletion source/about/cloud-shared.rst
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,12 @@ Mattermost Cloud Dedicated provides access to :doc:`audit and system logs </mana
Customization
~~~~~~~~~~~~~~

Approved plugins developed and/or tested by Mattermost are supported and available in the `Mattermost Marketplace <https://mattermost.com/marketplace/>`_. Custom plugins and integrations outside of Mattermost Marketplace aren’t currently supported. See the :ref:`plugins <about/integrations:plugins>` documentation for details on supported plugins in Mattermost Cloud deployments.
Approved plugins developed and/or tested by Mattermost are supported and available in the `Mattermost Cloud Marketplace <https://mattermost.com/marketplace/>`_, including:

.. include:: ./cloud-supported-integrations.rst
:start-after: :nosearch:

Custom plugins and integrations outside of Mattermost Marketplace aren’t currently supported.

Migrate from a self-hosted instance
------------------------------------
Expand Down
16 changes: 16 additions & 0 deletions source/about/cloud-supported-integrations.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
:orphan:
:nosearch:

- :ref:`Mattermost Calls <configure/plugins-configuration-settings:calls>`
- :doc:`Mattermost Copilot </configure/enable-copilot>`
- :doc:`Mattermost for Microsoft Teams </integrate/microsoft-teams-interoperability>` interoperability
- :doc:`Mattermost Playbooks </guides/repeatable-processes>`
- :doc:`Microsoft Calendar </integrate/microsoft-calendar-interoperability>` interoperability
- :doc:`Microsoft Teams Meetings </integrate/microsoft-teams-meetings-interoperability>` interoperability
- :doc:`GitHub </integrate/github-interoperability>` interoperability
- :doc:`GitLab </integrate/gitlab-interoperability>` interoperability
- :doc:`Jira </integrate/jira-interoperability>` interoperability
- :doc:`ServiceNow </integrate/servicenow-interoperability>` interoperability
- :doc:`User Survey </configure/manage-user-surveys>` integration
- :doc:`User satisfaction surveys </manage/user-satisfaction-surveys>`
- :doc:`Zoom </integrate/zoom-interoperability>`
10 changes: 10 additions & 0 deletions source/about/deprecated-features.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,16 @@ Mattermost Server v10.2.0
Removed features by Mattermost version
----------------------------------------

Mattermost Server v10.0.0
~~~~~~~~~~~~~~~~~~~~~~~~~

- We 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.
- Apps Framework is deprecated for new installs. Please extend Mattermost using webhooks, slash commands, OAuth2 apps, and plugins.
- Fully deprecated the ``/api/v4/image`` endpoint when the image proxy is disabled.
- Removed deprecated ``Config.ProductSettings``, ``LdapSettings.Trace``, and ``AdvancedLoggingConfig`` configuration fields.
- Removed deprecated ``pageSize`` query parameter from most API endpoints.
- Deprecated the experimental Strict CSRF token enforcement. This feature will be fully removed in Mattermost v11.

Mattermost Server v9.9.0
~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down
2 changes: 1 addition & 1 deletion source/about/faq-license.rst
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,7 @@ Rebranding
Copyright and Licensing of ``/mattermost`` open source code
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- Compiling and distributing your own version of the open source Mattermost ``/mattermost`` repo requires a) compliance with licenses in the repo, including `NOTICE.txt <https://github.com/mattermost/mattermost/blob/master/NOTICE.txt>`_, and b) the compiled version of the ``/mattermost`` source code should have the same open source license as the source code, `per our licensing policy <about/faq-license.html/>`_.
- Compiling and distributing your own version of the open source Mattermost ``/mattermost`` repo requires a) compliance with licenses in the repo, including `NOTICE.txt <https://github.com/mattermost/mattermost/blob/master/NOTICE.txt>`_, and b) the compiled version of the ``/mattermost`` source code should have the same open source license as the source code, :doc:`per our licensing policy </about/faq-license/>`.

Other considerations
^^^^^^^^^^^^^^^^^^^^
Expand Down
31 changes: 16 additions & 15 deletions source/about/integrations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Integrations overview

Mattermost provides a variety of methods to add functionality and customize the end-user experience to suit your organization’s needs, whether you want to add new user capabilities with slash commands, build an advanced chatbot, or completely change the functionality of your server.

A wide array of open source integrations are available and ready to use from Mattermost and our community. To see a list of open source integrations please see the `Mattermost Marketplace <https://mattermost.com/marketplace/>`__.
A wide array of open source integrations are available and ready to use from Mattermost and our community. To see a list of open source integrations please see the `Mattermost Marketplace <https://mattermost.com/marketplace/>`_.

For self-hosted deployments in small setups, you might host integrations on the same server on which Mattermost is installed. For larger deployments, you can set up a separate server for integrations, or add them to the server on which the external application is hosted. For example, if you’re self-hosting a Jira server, you could deploy a Jira integration on the Jira server itself. When self-hosting restrictions are less strict, AWS, Heroku, and other public cloud options can also be used.

Expand All @@ -14,52 +14,53 @@ Custom Apps

Apps are lightweight, interactive add-ons that can be written in any language and run on any HTTP-compatible hosting service. They enable you to connect with external services and build interactions that users can easily follow and work across the Mattermost web app, desktop app, and mobile app.

Prebuilt apps are available on the `Mattermost Marketplace <https://mattermost.com/marketplace/>`__.
Prebuilt apps are available on the `Mattermost Marketplace <https://mattermost.com/marketplace/>`_.

API
----

Mattermost provides complete access to `server APIs <https://api.mattermost.com/>`__, along with language-specific drivers to integrate into your own applications. Interact with users, channels, and everything else that happens on your Mattermost server via a REST API that meets the OpenAPI specification. The API is for developers who want to build bots and other interactions that don’t rely on customizing the Mattermost user experience.

`View the Mattermost API Reference <https://api.mattermost.com/>`__.
Mattermost provides complete access to `server APIs via the Mattermost API Reference <https://api.mattermost.com/>`_, along with language-specific drivers to integrate into your own applications. Interact with users, channels, and everything else that happens on your Mattermost server via a REST API that meets the OpenAPI specification. The API is for developers who want to build bots and other interactions that don’t rely on customizing the Mattermost user experience.

Plugins
-------

Plugins are the most comprehensive way to add new features and customization to self-hosted Mattermost deployments. These powerful integrations are written in Go and React and they’re ideal for customers wanting to change the behavior of the Mattermost server, desktop, and web apps without forking the core codebase to suit their organization’s needs.

Prebuilt plugins are available on the `Mattermost Marketplace <https://mattermost.com/marketplace/>`__, or you can `build your own plugin <https://developers.mattermost.com/integrate/plugins/>`__.
Prebuilt plugins are available on the `Mattermost Marketplace <https://mattermost.com/marketplace/>`_, or you can `build your own plugin <https://developers.mattermost.com/integrate/plugins/>`_.

.. note::

- :doc:`Mattermost Cloud Dedicated </about/cloud-dedicated>` customers supports custom Mattermost plugin uploads.
- Custom Mattermost plugins aren't available in :doc:`Mattermost Cloud Shared </about/cloud-shared>` deployments. You're limited to the plugins available in the Cloud Marketplace, including: :ref:`Mattermost Calls <configure/plugins-configuration-settings:calls>`, :doc:`Mattermost Copilot </configure/enable-copilot>`, :doc:`GitHub </integrate/github-interoperability>` interoperability, :doc:`GitLab </integrate/gitlab-interoperability>` interoperability, :doc:`Jira </integrate/jira-interoperability>` interoperability, :doc:`Playbooks </guides/repeatable-processes>`, :doc:`ServiceNow </integrate/servicenow-interoperability>` interoperability, :doc:`user satisfaction surveys </manage/user-satisfaction-surveys>`, and :doc:`Zoom </integrate/zoom-interoperability>`.
- :doc:`Mattermost Cloud Dedicated </about/cloud-dedicated>` customers supports custom Mattermost plugin uploads.
- Custom Mattermost plugins aren't available in :doc:`Mattermost Cloud Shared </about/cloud-shared>` deployments. You're limited to the plugins available in the Cloud Marketplace, including:

.. include:: ./cloud-supported-integrations.rst
:start-after: :nosearch:

Bots
-----

You can deploy interactive bots to help users with processes and tasks with Mattermost by issuing messages to users they can respond to using buttons and dropdown menus. Bots can be used together with apps and plugins. The Hubot open source project, created by GitHub, Inc., is among the most popular of the bot options.

Prebuilt bots are available on the `Mattermost Marketplace <https://mattermost.com/marketplace/>`__, or you can `configure your own bots <https://developers.mattermost.com/integrate/reference/bot-accounts/>`__.
Prebuilt bots are available on the `Mattermost Marketplace <https://mattermost.com/marketplace/>`_, or you can `configure your own bots <https://developers.mattermost.com/integrate/reference/bot-accounts/>`_.

Learn about `Mattermost Hubot integration (hubot-matteruser on npm) <https://www.npmjs.com/package/hubot-matteruser>`__ and `other open source community bots available <https://integrations.mattermost.com/>`__ or you can `build your own <https://developers.mattermost.com/integrate/reference/bot-accounts/>`__.
Learn about `Mattermost Hubot integration (hubot-matteruser on npm) <https://www.npmjs.com/package/hubot-matteruser>`_ and `other open source community bots available <https://integrations.mattermost.com/>`_ or you can `build your own <https://developers.mattermost.com/integrate/reference/bot-accounts/>`_.

Custom slash commands
---------------------

A :doc:`slash command </collaborate/run-slash-commands>` is similar to an `outgoing webhooks <https://developers.mattermost.com/integrate/webhooks/outgoing/>`__, but instead of listening to a channel, it's used as a command tool in a channel.
A :doc:`slash command </collaborate/run-slash-commands>` is similar to an `outgoing webhooks <https://developers.mattermost.com/integrate/webhooks/outgoing/>`_, but instead of listening to a channel, it's used as a command tool in a channel.

Slash commands enable users to trigger custom actions, such as creating Jira tickets or GitHub pull requests within Mattermost channels. See the :doc:`built-in slash commands </collaborate/built-in-slash-commands>` product documentation and the `custom slash command <https://developers.mattermost.com/integrate/slash-commands/custom/>`__ developer documentation to learn more.
Slash commands enable users to trigger custom actions, such as creating Jira tickets or GitHub pull requests within Mattermost channels. See the :doc:`built-in slash commands </collaborate/built-in-slash-commands>` product documentation and the `custom slash command <https://developers.mattermost.com/integrate/slash-commands/custom/>`_ developer documentation to learn more.

.. tip::
The Mattermost slash command format is compatible with Slack's format, so you can easily port commands from Slack.

Webhooks
--------

A webhook is a way for one app to send real-time data to another app. In Mattermost, `incoming webhooks <https://developers.mattermost.com/integrate/webhooks/incoming/>`__ receive data from external applications and make a post in a specified channel. They’re great for setting up notifications when something happens in an external application.
A webhook is a way for one app to send real-time data to another app. In Mattermost, `incoming webhooks <https://developers.mattermost.com/integrate/webhooks/incoming/>`_ receive data from external applications and make a post in a specified channel. They’re great for setting up notifications when something happens in an external application.

`Outgoing webhooks <https://developers.mattermost.com/integrate/webhooks/outgoing/>`__ take data from Mattermost, and send it to an external application. Then the outgoing webhook can post a response back in Mattermost. They’re great for listening in on channels, and then notifying external applications when a trigger word is used.
`Outgoing webhooks <https://developers.mattermost.com/integrate/webhooks/outgoing/>`_ take data from Mattermost, and send it to an external application. Then the outgoing webhook can post a response back in Mattermost. They’re great for listening in on channels, and then notifying external applications when a trigger word is used.

.. tip::

Expand All @@ -71,4 +72,4 @@ Source code customizations
--------------------------
As an open source project, we support your ability to modify the source code for the server or web app to make changes and customizations to meet your specific needs.

Learn about `forking our open source repositories <https://developers.mattermost.com/integrate/other-integrations/customization/>`__.
Learn about `forking our open source repositories <https://developers.mattermost.com/integrate/other-integrations/customization/>`_.
1 change: 1 addition & 0 deletions source/about/mattermost-mobile-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ See the [Mobile app changelog](/about/mobile-app-changelog) for release details,

| **Release** | **Released on** | **Support ends** | **Compatible with** |
|:---|:---|:---|:---|
| v2.20 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/mattermost-mobile/releases/tag/v2.20.0) \| {ref}`Changelog <release-v2-20-0>` | 2024-09-16 | 2024-10-15 | {ref}`v10.0 <release-v10.0-major-release>`, {ref}`v9.11 <release-v9-11-extended-support-release>`, {ref}`v9.10 <release-v9-10-feature-release>`, {ref}`v9.9 <release-v9-9-feature-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>` |
| v2.19 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/mattermost-mobile/releases/tag/v2.19.2) \| {ref}`Changelog <release-v2-19-2>` | 2024-08-16 | 2024-09-15 | {ref}`v9.11 <release-v9-11-extended-support-release>`, {ref}`v9.10 <release-v9-10-feature-release>`, {ref}`v9.9 <release-v9-9-feature-release>`, {ref}`v9.8 <release-v9-8-feature-release>`, {ref}`v9.5 <release-v9-5-extended-support-release>` |
| v2.18 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/mattermost-mobile/releases/tag/v2.18.1) \| {ref}`Changelog <release-v2-18-1>` | 2024-07-16 | 2024-08-15 | {ref}`v9.10 <release-v9-10-feature-release>` |
| v2.17 {ref}`FEATURE <release-types>` [Download](https://github.com/mattermost/mattermost-mobile/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>` |
Expand Down
1 change: 1 addition & 0 deletions source/about/mattermost-server-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Mattermost releases a new server version on the 16th of each month in [binary fo

| **Release** | **Released on** | **Support ends** |
|:---|:---|:---|
| v10.0 [Download](https://releases.mattermost.com/10.0.0/mattermost-10.0.0-linux-amd64.tar.gz) \| {ref}`Changelog <release-v10.0-major-release>` | 2024-09-16 | 2024-12-15 |
| v9.11 [Download](https://releases.mattermost.com/9.11.1/mattermost-9.11.1-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-11-extended-support-release>` | 2024-08-16 | 2025-05-15 {ref}`EXTENDED <release-types>` |
| v9.10 [Download](https://releases.mattermost.com/9.10.2/mattermost-9.10.2-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-10-feature-release>` | 2024-07-16 | 2024-10-15 |
| v9.9 [Download](https://releases.mattermost.com/9.9.3/mattermost-9.9.3-linux-amd64.tar.gz) \| {ref}`Changelog <release-v9-9-feature-release>` | 2024-06-14 | 2024-09-15 |
Expand Down
Loading

0 comments on commit 6ce29ee

Please sign in to comment.