diff --git a/source/_templates/custom-index.html b/source/_templates/custom-index.html index 9dad91fa203..2ba8272c1ae 100644 --- a/source/_templates/custom-index.html +++ b/source/_templates/custom-index.html @@ -316,7 +316,7 @@

Integrate and extend

diff --git a/source/about/certifications-and-compliance.rst b/source/about/certifications-and-compliance.rst index fc87c240357..32d04cde34b 100644 --- a/source/about/certifications-and-compliance.rst +++ b/source/about/certifications-and-compliance.rst @@ -9,7 +9,7 @@ This overview summarizes how Mattermost can help users in support of their inter GDPR compliance ---------------- -The following overview summarizes how Mattermost software can be used to assist in compliance programs covering the European Union's General Data Protection Regulation, also known as Regulation (EU): 2016/679 (`See full text `__) and how Mattermost, Inc., itself, adheres to regulatory requirements. +The following overview summarizes how Mattermost software can be used to assist in compliance programs covering the European Union's General Data Protection Regulation, also known as Regulation (EU): 2016/679 (`See full text `_) and how Mattermost, Inc., itself, adheres to regulatory requirements. Continual commitment to the principles of GDPR ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -17,11 +17,11 @@ Continual commitment to the principles of GDPR Mattermost is a collaboration hub for highly-trusted organizations and is committed to supporting the principles of GDPR to protect the data of people in the European Union. Mattermost adheres to this mission through the use of: - **Security Infrastructure:** Continual investment in security, privacy and compliance capabilities. -- **Contractual Obligations:** Appropriate contractual obligations through our terms of service, including the `Data Processing Addendum `__ in our standard `Terms of Service `__. -- **Privacy Measures:** Privacy measures are outlined in our `Privacy Policy `__. +- **Contractual Obligations:** Appropriate contractual obligations through our terms of service, including the `Data Processing Addendum `_ in our standard `Terms of Service `_. +- **Privacy Measures:** Privacy measures are outlined in our `Privacy Policy `_. - **Product Features:** To ensure data management and data portability. -To stay up to date with our efforts, please subscribe to `our regular newsletter `__. +To stay up to date with our efforts, please subscribe to `our regular newsletter `_. Security infrastructure ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -44,7 +44,7 @@ Mattermost adheres to contractual obligations for ensuring the proper management Privacy measures ~~~~~~~~~~~~~~~~~ -Mattermost outlines security measures to maintain the safety of personal data submitted by our customers and partners in our `Privacy Policy `__. +Mattermost outlines security measures to maintain the safety of personal data submitted by our customers and partners in our `Privacy Policy `_. Product features ~~~~~~~~~~~~~~~~ @@ -56,13 +56,13 @@ Data management - **Data Retention:** Use :doc:`data retention ` to automatically erase data after a set period of time, a feature that meets the Right to Erasure principle. In Team Edition, you can use database scripts to achieve the same result. - **Profile Deletion:** Delete a user’s personal information via :ref:`mmctl user delete `. This permanently deletes all user information including messages created by the user. -- **Self-Hosted Push Notification Service:** Self-host your own push notification service, or deploy mobile apps with any EMM provider that supports `AppConfig `__ to meet security and compliance policies. See :doc:`our Mobile App deployment documentation ` to learn more. +- **Self-Hosted Push Notification Service:** Self-host your own push notification service, or deploy mobile apps with any EMM provider that supports `AppConfig `_ to meet security and compliance policies. See :doc:`our Mobile App deployment documentation ` to learn more. Data portability ^^^^^^^^^^^^^^^^^ -- **Data Import:** Use the :doc:`bulk loading tool ` to migrate data from an existing messaging system, or for pre-populating a new installation with data. :ref:`Review this guide ` which summarizes the different approaches and meets the `Right to Data Portability `__ principle. -- **Data Export:** Use :doc:`compliance exports ` to export conversations from public, private and direct message channels in XML or EML format. Those in Team Edition can export conversations directly from the database, both `in PostgreSQL `__ and `in MySQL `__. +- **Data Import:** Use the :doc:`bulk loading tool ` to migrate data from an existing messaging system, or for pre-populating a new installation with data. :ref:`Review this guide ` which summarizes the different approaches and meets the `Right to Data Portability `_ principle. +- **Data Export:** Use :doc:`compliance exports ` to export conversations from public, private and direct message channels in XML or EML format. Those in Team Edition can export conversations directly from the database, both `in PostgreSQL `_ and `in MySQL `_. Accessibility compliance ------------------------- @@ -72,7 +72,7 @@ Adherence with accessibility standards is assisted in the following ways: - **508 Compliance:** For U.S. public sector organizations seeking to confirm 508 compliance, Mattermost publicly shares its :doc:`Voluntary Product Accessibility Template (VPAT) online `. - **WCAG 2.0L:** For meeting Web Contact Accessibility Guidelines 2.0 (WCAG), Mattermost has received a third-party "A" rating and is working towards an "AA" rating. - **ADA:** Mattermost compliance with the Americans with Disabilities Act (ADA) is achieved by offering the accessibility support detailed in the VPAT and WCAG 2.0 guidelines with Mattermost's online experience as the interface to accessibility tools. -- **Remediation:** Any technical issue in a current or future product release that would prevent compliance with accessibility ratings stated in product documentation would be considered a product defect and Mattermost would welcome the `public filing of an issue report against the defect `__ so that it may be resolved. +- **Remediation:** Any technical issue in a current or future product release that would prevent compliance with accessibility ratings stated in product documentation would be considered a product defect and Mattermost would welcome the `public filing of an issue report against the defect `_ so that it may be resolved. U.S. trade compliance --------------------- @@ -132,41 +132,41 @@ of assets, the denial of export privileges, and suspension or debarment from Gov For these reasons, please take the time to familiarize yourself with applicable export (and import) controls in the jurisdictions in which you operate. Although Mattermost cannot provide advice on export matters, this web page provides the information needed in order to export Mattermost products. -This overview is specific to the `U.S. Export Administration Regulations `__ (EAR), however, business operations may subject you to other regulations such as the `International Traffic in Arms Regulations `__. +This overview is specific to the `U.S. Export Administration Regulations `_ (EAR), however, business operations may subject you to other regulations such as the `International Traffic in Arms Regulations `_. General information ~~~~~~~~~~~~~~~~~~~~ -Start by taking a look at the `U.S. Bureau of Industry and Security `__ website. Then, navigate to `Part 730 `__ of the U.S. Export Administration Regulations to understand what the regulations cover and what is “Subject to -the EAR” under `734.2 `__ (“export controlled”). +Start by taking a look at the `U.S. Bureau of Industry and Security `_ website. Then, navigate to `Part 730 `_ of the U.S. Export Administration Regulations to understand what the regulations cover and what is “Subject to +the EAR” under `734.2 `_ (“export controlled”). Export classification and licensing ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Although what is subject to the Export Administration Regulations is quite broad, that does not mean an export license is required for every transaction. The foundation of understanding export controls related to hardware, software and -technology can be found within the `Commerce Control List `__ (CCL), which has 10 categories, 0-9, and is set up as a positive list. The first step is determining if the item to be exported is subject to the EAR. +technology can be found within the `Commerce Control List `_ (CCL), which has 10 categories, 0-9, and is set up as a positive list. The first step is determining if the item to be exported is subject to the EAR. -At Mattermost, our fully open source, publicly available software is `outside the scope of the EAR `__, as it is derived from publicly available encryption source code and the complete software package for both the source code (https://github.com/mattermost/) and binary versions are publicly available. Mattermost enterprise software is found in `Category 5, Part 2 `__ of the CCL as Telecommunications and Information Security items (hardware, software and technology). Most items in this category have encryption. +At Mattermost, our fully open source, publicly available software is `outside the scope of the EAR `_, as it is derived from publicly available encryption source code and the complete software package for both the source code (https://github.com/mattermost/) and binary versions are publicly available. Mattermost enterprise software is found in `Category 5, Part 2 `_ of the CCL as Telecommunications and Information Security items (hardware, software and technology). Most items in this category have encryption. -Often a license exception under `Part 740 `__ is available where a Commerce Control List item lists the available license exception(s) specific to an Export Control Classification Number (ECCN), based on a combination of factors. +Often a license exception under `Part 740 `_ is available where a Commerce Control List item lists the available license exception(s) specific to an Export Control Classification Number (ECCN), based on a combination of factors. -Mattermost Enterprise Edition (includes Mattermost Professional & Enterprise) is found under `ECCN 5D002 `__, with a license exception available from `“ENC” `__ for our Enterprise and Professional software, with encryption features derived from open-source software. Encryption products, under the export regulations, have multiple levels of controls and requirements. BIS has a separate section of their website that has an overview, and many links, covering encryption under `Encryption and Export Administration Regulations (EAR)`__ that you may want to review. These guidelines include helpful flow charts for determining if an item is subject to encryption controls, tables and other details. +Mattermost Enterprise Edition (includes Mattermost Professional & Enterprise) is found under `ECCN 5D002 `_, with a license exception available from `“ENC” `_ for our Enterprise and Professional software, with encryption features derived from open-source software. Encryption products, under the export regulations, have multiple levels of controls and requirements. BIS has a separate section of their website that has an overview, and many links, covering encryption under `Encryption and Export Administration Regulations (EAR) `_ that you may want to review. These guidelines include helpful flow charts for determining if an item is subject to encryption controls, tables and other details. The other key areas to be aware of for an export of Mattermost software or technology are: **Sanctions**: There are comprehensive sanctions to Cuba, Iran, North Korea, Syria, and other countries/territories with specific prohibitions, such as Crimea, Donetsk, and Luhansk regions of Ukraine, Belarus, Russia, Venezuela, Myanmar/Burma, and Cambodia. Details can be -located at `BIS `__ and `OFAC `__. The countries and their sanctions are subject to change. +located at `BIS `_ and `OFAC `_. The countries and their sanctions are subject to change. **WMD (Weapons of Mass Destruction)**: Mattermost, its customers and its business partners may not export to parties involved -in `proliferation `__ of weapons of mass destruction, along with other prohibited end-uses under the U.S. Export Administration Regulations (“EAR”). +in `proliferation `_ of weapons of mass destruction, along with other prohibited end-uses under the U.S. Export Administration Regulations (“EAR”). -**General Prohibitions**: Information on General Prohibitions under the EAR is located `here `__. Application of the applicability of these General Prohibitions is based on a combination of factors. These include: classification of the commodity, destination, end-user, end-use and conduct. +**General Prohibitions**: Information on General Prohibitions under the EAR is located `here `_. Application of the applicability of these General Prohibitions is based on a combination of factors. These include: classification of the commodity, destination, end-user, end-use and conduct. -**Restricted Parties**: You may not export to parties listed on the US government's `restricted parties lists `__, and should be screening against these prior to export. There is a `consolidated screening list `__ provided by the U.S. government at export.gov at no charge that can be used for screening. Additionally, there are specific restrictions on export to military end-users and military intelligence end-users. +**Restricted Parties**: You may not export to parties listed on the US government's `restricted parties lists `_, and should be screening against these prior to export. There is a `consolidated screening list `_ provided by the U.S. government at export.gov at no charge that can be used for screening. Additionally, there are specific restrictions on export to military end-users and military intelligence end-users. **Deemed Exports**: Release of controlled technology to foreign persons in the U.S. is "deemed" to be an export to the -person’s country or countries of nationality and is found in `734.2(b) `__ of the EAR, which you can read about under the Export Administration Regulations on the BIS website. +person’s country or countries of nationality and is found in `734.2(b) `_ of the EAR, which you can read about under the Export Administration Regulations on the BIS website. **Know Your Customer**: By reviewing the BIS website, you will notice that it is very important to “know your customers," and to be aware of “Red Flags”. Be sure to screen business partners and customers to ensure compliance. @@ -202,7 +202,7 @@ Selecting **Contact us** in the Mattermost Admin Advisor will send some informat Are the server access logs containing IP addresses a GDPR compliance issue? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Based on our interpretation of `article 49 of GDPR `__, processing personal data for the purpose of ensuring network and information security is acceptable. Moreover: +Based on our interpretation of `article 49 of GDPR `_, processing personal data for the purpose of ensuring network and information security is acceptable. Moreover: - You can control access to the logs via restricted access to the System Console and the server. - As a self-hosted software, you have full control and ownership of the logs, with the ability to set up a purge schedule to meet your needs. @@ -216,11 +216,11 @@ We are in the process of acquiring Authority to Operate (ATO) and Certificate of How do you ensure personal data stays within European Union? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -When the customer’s installation of Mattermost is self-hosted, Mattermost does not process any personal data under the jurisdiction of the data privacy laws governing within the European Union. The Mattermost support team leverages Zendesk customer service software, which hosts Mattermost information within the United States. For more information on Zendesk, please see their `Privacy and Data Protection `__ page. +When the customer’s installation of Mattermost is self-hosted, Mattermost does not process any personal data under the jurisdiction of the data privacy laws governing within the European Union. The Mattermost support team leverages Zendesk customer service software, which hosts Mattermost information within the United States. For more information on Zendesk, please see their `Privacy and Data Protection `_ page. Zendesk privacy and data protection safeguards notwithstanding, the provision of support services is part of the contractual obligations between Mattermost and its customers. In order for Mattermost to provide such support, a customer must be able to identify as a licensed user, therefore requiring the user to provide personal data to the support agent. Regardless of where the support agent is located, the personal data will indeed be hosted outside of the EU. -However, pursuant to Section (b) of Article 49 of GDPR, transfers of personal data which are "necessary for the performance of a contract between the data subject and the controller" may be transferred to a third country or international organization. Accordingly these transfers would be done in alignment with the requirements of GDPR. For more information, see our `Mattermost Privacy Policy `__ page. +However, pursuant to Section (b) of Article 49 of GDPR, transfers of personal data which are "necessary for the performance of a contract between the data subject and the controller" may be transferred to a third country or international organization. Accordingly these transfers would be done in alignment with the requirements of GDPR. For more information, see our `Mattermost Privacy Policy `_ page. ***DISCLAIMER:** MATTERMOST DOES NOT POSITION ITS PRODUCTS AS “GUARANTEED COMPLIANCE SOLUTIONS”. WE MAKE NO GUARANTEE THAT YOU WILL ACHIEVE REGULATORY COMPLIANCE USING MATTERMOST PRODUCTS. YOUR LEVEL OF SUCCESS IN ACHIEVING REGULATORY COMPLIANCE DEPENDS ON YOUR INTERPRETATION OF THE APPLICABLE REGULATION, AND THE ACTIONS YOU TAKE TO COMPLY WITH THEIR REQUIREMENTS. SINCE THESE FACTORS DIFFER ACCORDING TO INDIVIDUALS AND BUSINESSES, WE CANNOT GUARANTEE YOUR SUCCESS, NOR ARE WE RESPONSIBLE FOR ANY OF YOUR ACTIONS. NO GUARANTEES ARE MADE THAT YOU WILL ACHIEVE ANY SPECIFIC COMPLIANCE RESULTS FROM THE USE OF MATTERMOST OR FROM ANY RECOMMENDATIONS CONTAINED ON OUR WEBSITES, AND AS SUCH, THIS SHOULD NOT BE A SUBSTITUTE TO CONSULTING WITH YOUR OWN LEGAL AND COMPLIANCE REPRESENTATIVES ON THESE MATTERS. @@ -236,4 +236,4 @@ Are you 508 compliant? Yes, the Mattermost platform is compliant with 508. -Learn more about our :doc:`VPAT Template for 508 compliance `, and `how Mattermost approaches accessibility in product development `__. \ No newline at end of file +Learn more about our :doc:`VPAT Template for 508 compliance `, and `how Mattermost approaches accessibility in product development `_. \ No newline at end of file diff --git a/source/about/faq-business.rst b/source/about/faq-business.rst index 0faefdc0538..04f504f3fa5 100644 --- a/source/about/faq-business.rst +++ b/source/about/faq-business.rst @@ -15,26 +15,26 @@ In contrast, Mattermost, as the copyright holder to the collection of the Matter How can I create an open source derivative work of Mattermost? -------------------------------------------------------------- -If you're looking to customize the look and feel of Mattermost, see `documentation on customization `__. For advanced customization, the system's user experience is available in different repositories for web, mobile apps, and desktop apps and custom experiences can be developed and integrated with either Mattermost Team Edition or Mattermost Enterprise Edition via the system APIs and drivers. +If you're looking to customize the look and feel of Mattermost, see `documentation on customization `_. For advanced customization, the system's user experience is available in different repositories for web, mobile apps, and desktop apps and custom experiences can be developed and integrated with either Mattermost Team Edition or Mattermost Enterprise Edition via the system APIs and drivers. If, instead of using Mattermost Team Edition or Mattermost Enterprise Edition, you choose to compile your own version of the system using the open source code from ``/mattermost-server``, there are a number of factors to consider: Security ~~~~~~~~ -- If you run a fork of the Mattermost server, we highly recommend you only deploy the system securely behind a firewall and to pay close attention to `Mattermost security updates `__. Mattermost Team Edition and Mattermost Enterprise Edition release security update patches when reports of new attacks are received and verified. Mattermost waits until 14 days after a security patch is released before publicly detailing its nature so that users and customers can upgrade before the security vulnerability is widely known. A malicious user can potentially make use of Mattermost security disclosures to exploit a fork of Mattermost if the security upgrade is not promptly incorporated into the forked version. +- If you run a fork of the Mattermost server, we highly recommend you only deploy the system securely behind a firewall and to pay close attention to `Mattermost security updates `_. Mattermost Team Edition and Mattermost Enterprise Edition release security update patches when reports of new attacks are received and verified. Mattermost waits until 14 days after a security patch is released before publicly detailing its nature so that users and customers can upgrade before the security vulnerability is widely known. A malicious user can potentially make use of Mattermost security disclosures to exploit a fork of Mattermost if the security upgrade is not promptly incorporated into the forked version. Rebranding ~~~~~~~~~~ -- When you create a derivative version of Mattermost and share it with others as a product, you need to replace the Mattermost name and logo from the system, among other requirements, per the `Mattermost trademark policy `__. +- When you create a derivative version of Mattermost and share it with others as a product, you need to replace the Mattermost name and logo from the system, among other requirements, per the `Mattermost trademark policy `_. - You can rebrand your system using :doc:`custom branding tools `. -- For advanced whitelabelling, and to whitelabel in Team Edition under MIT license without Enterprise Edition branding tools, you can manually update files on the Mattermost server `per product documentation. `__ This can also be done without forking. +- For advanced whitelabelling, and to whitelabel in Team Edition under MIT license without Enterprise Edition branding tools, you can manually update files on the Mattermost server `per product documentation. `_ This can also be done without forking. Copyright and Licensing of ``/mattermost-server`` open source code ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- Compiling and distributing your own version of the open source Mattermost ``/mattermost-server`` repo requires a) compliance with licenses in the repo, including `NOTICE.txt `__, and b) the compiled version of the ``/mattermost-server`` source code should have the same open source license as the source code, `per our licensing policy `__. +- Compiling and distributing your own version of the open source Mattermost ``/mattermost-server`` repo requires a) compliance with licenses in the repo, including `NOTICE.txt `_, and b) the compiled version of the ``/mattermost-server`` source code should have the same open source license as the source code, :doc:`per our licensing policy `. Other considerations ~~~~~~~~~~~~~~~~~~~~ @@ -47,7 +47,7 @@ Other considerations Will Mattermost complete questionnaires requiring confidential data without an NDA? ----------------------------------------------------------------------------------- -No, Mattermost will not complete questionnaires requiring confidential data without a non-disclosure agreement. You can find `Mattermost's standard mutual non-disclosure agreement online `__. +No, Mattermost will not complete questionnaires requiring confidential data without a non-disclosure agreement. You can find `Mattermost's standard mutual non-disclosure agreement online `_. Why does Mattermost have a discount for certain kinds of non-profits but not for others? ---------------------------------------------------------------------------------------- @@ -59,7 +59,7 @@ See our :ref:`License and Subscription `__ and felt it was unfair. +The Mattermost open source project was created by `a group of developers who had their data paywalled by a proprietary online messaging service `_ and felt it was unfair. Because of this, the Mattermost /mattermost-server repository uses an open source license that requires derivative works to use the same open source license. This prevents the creation of derivative works that are not open source, and the situation where end users would not have access to the source code of the systems they use, and hence be at risk of "lock in". diff --git a/source/about/faq-integrations.rst b/source/about/faq-integrations.rst index c6e82514981..1042d48d62b 100644 --- a/source/about/faq-integrations.rst +++ b/source/about/faq-integrations.rst @@ -8,7 +8,7 @@ Mattermost is an open source, self-hosted alternative to proprietary SaaS servic While you're welcome to use the Mattermost source code under its open source license, Mattermost, Inc. does not offer support or technical advice for proprietary SaaS projects that result in customers potentially being paywalled from their data should they stop paying SaaS fees. -To learn more about why we strongly believe that users and customers should always have access to their data, please read `why we created Mattermost `__. +To learn more about why we strongly believe that users and customers should always have access to their data, please read `why we created Mattermost `_. What's the difference between incoming and outgoing webhooks? ------------------------------------------------------------- @@ -46,7 +46,7 @@ Mattermost doesn't currently support the ability to attach files to a post made Where can I find existing integrations? --------------------------------------- -[Visit the Mattermost Marketplace](https://mattermost.com/marketplace) to access open source integrations to common tools like Jira, Jenkins, and GitLab, along with interactive bot applications, and other communication tools that are freely available for use and customization. +Visit the `Mattermost Marketplace `_ to access open source integrations to common tools like Jira, Jenkins, and GitLab, along with interactive bot applications, and other communication tools that are freely available for use and customization. Alternatively, within Mattermost, when logged in as an Administrator, you can click on the "Marketplace" option in the main menu and easily install plugins or apps from there. @@ -58,6 +58,6 @@ For self-hosted deployments in small setups, you might host integrations on the Where can I get more information about integrations? ---------------------------------------------------- -Come `join our Contributors community channel `__ on our daily build server, where you can discuss questions with community members and the Mattermost core team. +Come `join our Contributors community channel `_ on our daily build server, where you can discuss questions with community members and the Mattermost core team. -Join our `Developers channel `__ for technical discussions, and visit our `Integrations channel `__ for all integrations and plugins discussions. \ No newline at end of file +Join our `Developers channel `_ for technical discussions, and visit our `Integrations channel `_ for all integrations and plugins discussions. \ No newline at end of file diff --git a/source/about/faq-license.rst b/source/about/faq-license.rst index 08d1af72dd0..8cac841f86a 100644 --- a/source/about/faq-license.rst +++ b/source/about/faq-license.rst @@ -64,7 +64,7 @@ Mattermost Partnership Agreements +-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | Partnership Agreement | Agreement | +=============================================================================+===================================================================================================================+ -| Mattermost Authorized Reseller Agreement | `Mattermost Authorized Reseller Agreement `__ | +| Mattermost Authorized Reseller Agreement | `Mattermost Authorized Reseller Agreement `_ | +-----------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ Mattermost Confidentiality Agreements @@ -73,7 +73,7 @@ Mattermost Confidentiality Agreements +-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ | Confidentiality Agreement | Agreement | +=============================================================================+=======================================================================================================================================+ -| Mattermost Mutual Non-Disclosure Agreement | `Mattermost Mutual Non-Disclosure Agreement `__ | +| Mattermost Mutual Non-Disclosure Agreement | `Mattermost Mutual Non-Disclosure Agreement `_ | +-----------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ Working for Mattermost @@ -82,9 +82,9 @@ Working for Mattermost +-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ | Service | Terms and Conditions | +=============================================================================+==================================================================================================================================================+ -| Mattermost Professional Consulting Services | `Mattermost Professional Consulting Services Agreement `__ | +| Mattermost Professional Consulting Services | `Mattermost Professional Consulting Services Agreement `_ | +-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ -| Mattermost Consulting | `Mattermost Consulting Terms `__ | +| Mattermost Consulting | `Mattermost Consulting Terms `_ | +-----------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ Source available licensing diff --git a/source/about/install-mattermost-for-microsoft-teams-plugin.rst b/source/about/install-mattermost-for-microsoft-teams-plugin.rst index c2e9b780b54..001f808a3e9 100644 --- a/source/about/install-mattermost-for-microsoft-teams-plugin.rst +++ b/source/about/install-mattermost-for-microsoft-teams-plugin.rst @@ -156,7 +156,7 @@ Trobleshooting FAQ No. Currently, only accounts with the same email addresses are allowed to be connected. Specify the email address that matches your Mattermost account. -If connecting a Mattermost account to a Microsoft Teams account with a different email address is something your workspace requires, there is an open `Github issue `__ for you to share your feedback. +If connecting a Mattermost account to a Microsoft Teams account with a different email address is something your workspace requires, there is an open `GitHub issue `__ for you to share your feedback. Get help -------- diff --git a/source/conf.py b/source/conf.py index f806bc852b2..0e053fd8ab5 100644 --- a/source/conf.py +++ b/source/conf.py @@ -358,6 +358,8 @@ def setup(_: Sphinx): "https://docs.mattermost.com/configure/site-configuration-settings.html#file-sharing-and-downloads", "administration/config-settings.html#allow-untrusted-internal-connections-to": "https://docs.mattermost.com/configure/environment-configuration-settings.html#allow-untrusted-internal-connections", +"administration/version-archive.html": + "https://docs.mattermost.com/upgrade/version-archive.html", # Boards redirects "boards/navigating-mattermost-boards.html": diff --git a/source/configure/customizing-mattermost.rst b/source/configure/customizing-mattermost.rst index 0d7d8f966b9..49d1ca1a821 100644 --- a/source/configure/customizing-mattermost.rst +++ b/source/configure/customizing-mattermost.rst @@ -6,7 +6,7 @@ Customizing Mattermost There are several ways to customize your Mattermost server. -If customizing Mattermost, please avoid branding that could be confused with the Mattermost brand. For example, it's okay to brand as "Healthcare Central" because it's a completely different brand. "Mattermost Healthcare Central" is not okay, because it can potentially be confused with the Mattermost brand. Please see the `Mattermost trademark guidelines `__ for details. +If customizing Mattermost, please avoid branding that could be confused with the Mattermost brand. For example, it's okay to brand as "Healthcare Central" because it's a completely different brand. "Mattermost Healthcare Central" is not okay, because it can potentially be confused with the Mattermost brand. Please see the `Mattermost trademark guidelines `_ for details. While you're welcome to add your own copyright notice in the user interface if you feel it is warranted by your changes, we ask that you do not remove the Mattermost, Inc. copyright notice from the login footer or from the About dialog. @@ -16,7 +16,7 @@ Mattermost Web App The Mattermost webapp is licensed under the Apache 2.0 license. To modify and use with the Mattermost server, you can: 1. Install the Mattermost server by following one of our installation guides -2. Fork the `mattermost `__ repository +2. Fork the `mattermost `_ repository 3. Go to the web app code located in the ``webapp`` directory and make your changes 4. Run ``make package`` to create ``mattermost-webapp.tar.gz`` 5. Copy ``mattermost-webapp-tar.gz`` to the location Mattermost was installed in Step 1 @@ -45,7 +45,7 @@ The Mattermost mobile apps can be customized if you choose to build the apps you To brand the mobile apps: -1. Fork the `mattermost-mobile `__ repository +1. Fork the `mattermost-mobile `_ repository 2. Replace the name, images, and any key text strings 3. :doc:`Compile the apps <../deploy/build-custom-mobile-apps>` 4. Deploy the apps to an app store @@ -59,7 +59,7 @@ The Mattermost desktop apps can be customized if you choose to build the apps yo To brand the desktop apps: -1. Fork the `mattermost/desktop `__ repository +1. Fork the `mattermost/desktop `_ repository 2. Replace the name, images, and any key text strings -3. Refer to `this documentation `__ for help with compiling the apps +3. Refer to `the Mattermost Developer documentation `_ for help with compiling the apps 4. Share the desktop application with your users diff --git a/source/configure/enabling-chinese-japanese-korean-search.rst b/source/configure/enabling-chinese-japanese-korean-search.rst index 924dc609781..ae398dd6c2d 100644 --- a/source/configure/enabling-chinese-japanese-korean-search.rst +++ b/source/configure/enabling-chinese-japanese-korean-search.rst @@ -18,7 +18,7 @@ Below is additional information on how to configure the database for different l 尽管在 Mattermost 8.0 更新后，官方推荐为了更好的性能请使用 PostgreSQL 作为后端数据库。 但就目前而言，使用 MySQL 能够更容易的实现中文语言的全文搜索功能，在妥善配置 ngram 后，根据官方数据库构造重新生成索引即可达成。 -具体的操作方式，可参考： `Cannot search CJK contents `__。 +具体的操作方式，可参考： `Cannot search CJK contents `_。 有关 PostgreSQL 的配置方式，请参考以下流程： @@ -98,9 +98,9 @@ Below is additional information on how to configure the database for different l 未尽事宜，可以参考以下链接： - - `SCWS 官方文档 `__ - - `Zhparser 官方文档 `__ - - `Mattermost 建表语句 `__ + - `SCWS 官方文档 `_ + - `Zhparser 官方文档 `_ + - `Mattermost 建表语句 `_ 日本語 / Japanese ----------------- @@ -128,7 +128,7 @@ Qiita上で Mattermost のインストールおよび構成のガイドを提供 이 문제에 대한 논의는 이 `이슈 `_ 에서 시작되었습니다. -한국어 버전 이용 시 문제점을 발견하면 `Localization 채널 `__ 또는 `한국어 채널 `__ 에서 의견을 제시할 수 있습니다. +한국어 버전 이용 시 문제점을 발견하면 `Localization 채널 `_ 또는 `한국어 채널 `_ 에서 의견을 제시할 수 있습니다. 검색을 위한 데이터베이스 설정 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -140,7 +140,7 @@ MySQL: MySQL에서는 전문 검색(Full-text search) 기능에 제한이 있기 MySQL 해결 방법 ~~~~~~~~~~~~~~~~~ -1. `n-gram parser `__ 를 이용하기 위해서는 MySQL의 버전이 5.7.6 이상이어야 합니다. +1. n-gram parser 를 이용하기 위해서는 MySQL의 버전이 5.7.6 이상이어야 합니다. 2. MySQL의 구성 파일에서 n-gram의 최소 토큰 크기를 다음과 같이 설정합니다. @@ -154,14 +154,14 @@ MySQL 해결 방법 4. 일부 테이블의 전문 검색 색인을 다음과 같이 재구성합니다. -- 게시물 검색을 위한 설정 ( `참조 `__ ) +- 게시물 검색을 위한 설정 ( `참조 `_ ) .. code:: sql DROP INDEX idx_posts_message_txt ON Posts; CREATE FULLTEXT INDEX idx_posts_message_txt ON Posts (Message) WITH PARSER ngram; -- 해시 태그 검색을 위한 설정 ( `참조 `__ ) +- 해시 태그 검색을 위한 설정 ( `참조 `_ ) .. code:: sql diff --git a/source/configure/integrations-configuration-settings.rst b/source/configure/integrations-configuration-settings.rst index 0bfd675ced1..cfec405a7d1 100644 --- a/source/configure/integrations-configuration-settings.rst +++ b/source/configure/integrations-configuration-settings.rst @@ -275,8 +275,8 @@ Enable GIF picker | This feature's ``config.json`` setting is ``"EnableGifPicker": true`` with options ``true`` and ``false``. | +------------------------------------------------------------------------------------------------------------+ -.. note:: - :ref:`Link previews ` must be enabled in order to display GIF link previews. Mattermost deployments restricted to access behind a firewall must open port 443 to both https://api.gfycat.com/v1 and https://gfycat.com/ (for all request types) for this feature to work. +.. important:: + :ref:`Link previews ` must be enabled in order to display GIF link previews. Mattermost deployments restricted to access behind a firewall must open port 443 to both ``https://api.gfycat.com/v1`` and ``https://gfycat.com/`` (for all request types) for this feature to work. .. config:setting:: integrate-gfycatapikey :displayname: Gfycat API key (Integrations) diff --git a/source/configure/plugins-configuration-settings.rst b/source/configure/plugins-configuration-settings.rst index 0c5948b15fe..900d9e3bd4f 100644 --- a/source/configure/plugins-configuration-settings.rst +++ b/source/configure/plugins-configuration-settings.rst @@ -800,7 +800,7 @@ Transcriber model size | | - ``config.json`` setting: ``PluginSettings.Plugins.com.mattermost.calls.transcribermodelsize`` | | The default is **Base**. This is a required value. | | +--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| **Note**: The model size setting will affect the performance of the job service. Refer to the :ref: configure call recordings and transcriptions `` documentation for more information. This setting is available starting in plugin version 0.22. | +| **Note**: The model size setting will affect the performance of the job service. Refer to the :ref:`configure call recordings and transcriptions ` documentation for more information. This setting is available starting in plugin version 0.22. | +--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. config:setting:: plugins-callsenableipv6 diff --git a/source/deploy/deployment-overview.rst b/source/deploy/deployment-overview.rst index 74a75592a70..7f2b10fa9dd 100644 --- a/source/deploy/deployment-overview.rst +++ b/source/deploy/deployment-overview.rst @@ -8,6 +8,7 @@ The following Mattermost network diagram illustrates a private cloud deployment .. image:: ../images/network-diagram.svg :alt: Mattermost network diagram shows how the components of a private cloud deployment could be deployed. Includes optional configurations for scaling for larger enterprise organizations. + :class: bg-white .. note:: diff --git a/source/deploy/desktop-app-changelog.rst b/source/deploy/desktop-app-changelog.rst index f7b608bd95d..08455fc25ab 100644 --- a/source/deploy/desktop-app-changelog.rst +++ b/source/deploy/desktop-app-changelog.rst @@ -1131,7 +1131,7 @@ Known Issues - Users are unable to zoom in/out on the desktop app. This bug will be fixed after a major version upgrade of Electron to v6.0.0. - ``CMD+Z`` doesn't undo on the Mac desktop app. -- Unable to exit full screen Youtube videos. +- Unable to exit full screen YouTube videos. - "RIght-click + Copy" does not work. - Notifications appear in sequence rather than stacking on Windows. - Clicking on notifications when using the MSI installer(s) doesn't focus the app or the channel that triggered the notification. diff --git a/source/deploy/legacy-cloud-changelog.md b/source/deploy/legacy-cloud-changelog.md index e16b97e963f..eb0f171e27c 100644 --- a/source/deploy/legacy-cloud-changelog.md +++ b/source/deploy/legacy-cloud-changelog.md @@ -906,7 +906,7 @@ From Mattermost v9.2, see the [Mattermost Changelog](https://docs.mattermost.com ### Bug Fixes - Fixed an issue with incorrect mention counts in unread channels. - - Fixed an issue where the cursor displayed as a pointer instead of as an arrow in embedded Youtube preview images. + - Fixed an issue where the cursor displayed as a pointer instead of as an arrow in embedded YouTube preview images. - Fixed an issue where formatting was applied to selected spaces after a word. - Fixed an issue where an error with an option to refetch data was not displayed and instead a blank screen was shown when there was a failure fetching Cloud data. - Fixed an issue where screen readers did not announce that the channel interface language dropdown in **Settings > Display > Language > Change** is a dropdown. @@ -2490,7 +2490,7 @@ From Mattermost v9.2, see the [Mattermost Changelog](https://docs.mattermost.com ### Bug Fixes - Fixed an issue where users were unable to deactivate MFA for their accounts even if MFA was disabled on the server. - - Fixed an issue where user settings on API could be set if LDAP Sync was on. For LDAP and SAML users, the following fields cannot be changed via the API if the corresponding LDAP/SAML attributes have been set: first name, last name, position, nickname, email, profile picture. For OAUTH users (i.e., Gitlab, Google, Office365 and OpenID), the following fields cannot be changed via the API: first name, last name. All users who authenticate via a method other than email cannot change their username via the API. + - Fixed an issue where user settings on API could be set if LDAP Sync was on. For LDAP and SAML users, the following fields cannot be changed via the API if the corresponding LDAP/SAML attributes have been set: first name, last name, position, nickname, email, profile picture. For OAUTH users (i.e., GitLab, Google, Office365 and OpenID), the following fields cannot be changed via the API: first name, last name. All users who authenticate via a method other than email cannot change their username via the API. - Fixed a possible panic on post creation when the collapsed threads feature was enabled. - Fixed a database deadlock that could happen if a sidebar category was updated and deleted at the same time. - Fixed an issue where the sidebar **Text Hover BG Theme** color didn’t work on the left-hand side. diff --git a/source/deploy/legacy-self-hosted-changelog.md b/source/deploy/legacy-self-hosted-changelog.md index 83d178f4e39..e2f284268e8 100644 --- a/source/deploy/legacy-self-hosted-changelog.md +++ b/source/deploy/legacy-self-hosted-changelog.md @@ -6338,7 +6338,7 @@ Mattermost v5.15.0 contains low level security fixes. [Upgrading](https://docs.m - Fixed some bugs related to the new [keyboard accessibility](https://docs.mattermost.com/help/getting-started/accessibility.html) feature. - Fixed an issue where the "@" sign was replaced with keyboard accessibility feature on Italian keyboard. - Fixed an issue where joining a new channel with few posts sometimes did not take the user to the bottom of the channel. - - Fixed an issue where scroll pop sometimes occured with embedded Youtube links. + - Fixed an issue where scroll pop sometimes occured with embedded YouTube links. - Fixed an issue with stuttery dropdowns in Safari. - Fixed an issue where clicking on a post would highlight it after returning to the tab/window. - Fixed an issue where SVG attachments bled over into subsequent posts. @@ -6566,7 +6566,7 @@ Multiple setting options were added to `config.json`. Below is a list of the add - Post and comment boxes are expanding too early on Firefox. - Modifying config files causes compliance exports to run twice. - Using channel autocomplete while editing post causes current channel to be unread. - - Scroll pop may occur with embedded Youtube links. + - Scroll pop may occur with embedded YouTube links. - Clicking on a post will highlight it after returning to the tab/window. - Plugin translation files are not updated on web-client when plugins are upgraded. - Changes to Account Settings are being saved even when user does not clicks on Save button. @@ -12551,7 +12551,7 @@ The following config settings will only work on servers with an Enterprise Licen - Formatting of multiple lists in a row breaks markdown. - Hitting the URL of a private team you used to belong to shows a blank Team Selection page. - Accessing the System Console URL when logged out causes the browser to hang. -- Youtube videos show as "Video not found" on Desktop App +- YouTube videos show as "Video not found" on Desktop App - Search terms contained in hashtags are not highlighted in the search results. - Files sent in private messages to members in a different team are not accessible. - Center channel appears blank after initial page load on iOS. @@ -12724,7 +12724,7 @@ The following config settings will only work on servers with an Enterprise Licen - On Firefox, System Console sidebar completely disappears when an AD/LDAP setting is saved - On Firefox, CTRL/CMD+U keyboard shortcut doesn't work - Copying and pasting an image from a browser doesn't work -- Youtube videos continue playing when collapsed +- YouTube videos continue playing when collapsed - Code theme under Account Settings > Display > Theme doesn't save unless entered in vectorized form - `/join` sometimes throws an error - When upgrading to 3.X, syntax highlighting using Solarized code theme is lost @@ -12778,7 +12778,7 @@ Notes on patch releases: - v3.0.3, released 2016-05-27 - Fixed an error with AD/LDAP signup if user already existed. - Fixed an error where setting language to one of the supported langugages caused a blank page. - - Fixed an error where upgrading team admins on the primary team with AD/LDAP and Gitlab accounts caused an error. + - Fixed an error where upgrading team admins on the primary team with AD/LDAP and GitLab accounts caused an error. - v3.0.2, released 2016-05-17 - Security update to reduce information disclosure, thanks to Andreas Lindh for [reporting responsibly](https://mattermost.org/responsible-disclosure-policy/) - Fixed an error where, when using Postgres, attempting to log in with an AD/LDAP that has the same email address or username as an email-based account shows a confusing error message. diff --git a/source/deploy/postgres-migration.rst b/source/deploy/postgres-migration.rst index d6255487157..4438c440f8c 100644 --- a/source/deploy/postgres-migration.rst +++ b/source/deploy/postgres-migration.rst @@ -30,6 +30,16 @@ Required tools - ``go install github.com/mattermost/dbcmp/cmd/dbcmp@latest`` +System requirements and configurations +-------------------------------------- + +Before starting the migration process, it's essential to ensure that your system meets the necessary requirements for a smooth and efficient migration. We strongly recommend the following system specifications and adjustments: + +- Ensure you have enough system memory resources. 16GB of RAM is recommended as a default. In scenarios where system memory is insufficient, users can fine-tune pgLoader settings, such as the number of workers, prefetch rows, and rows per range. These adjustments can help optimize resource utilization based on available system resources. +- A multi-core processor with sufficient processing power is recommended for the migration process, especially when dealing with large datasets. +- Ensure that there is enough disk space available for storing both the MySQL and PostgreSQL databases, as well as any temporary files generated during the migration process. The amount of required disk space depends on the size of the databases being migrated. +- To improve performance further, users may choose to manually drop indexes on the target PostgreSQL database before initiating the migration process. This approach can potentially accelerate the migration by reducing overhead with index builds during data insertion. + Before the migration -------------------- @@ -211,6 +221,7 @@ Once we set the schema to a desired state, we can start migrating the **data** b CAST column Channels.Type to "channel_type" drop typemod, column Teams.Type to "team_type" drop typemod, column UploadSessions.Type to "upload_session_type" drop typemod, + column ChannelBookmarks.Type to "channel_bookmark_type" drop typemod, column Drafts.Priority to text, type int when (= precision 11) to integer drop typemod, type bigint when (= precision 20) to bigint drop typemod, diff --git a/source/getting-started/enterprise-roll-out-checklist.rst b/source/getting-started/enterprise-roll-out-checklist.rst index 57cac85ebce..a02eb955de4 100644 --- a/source/getting-started/enterprise-roll-out-checklist.rst +++ b/source/getting-started/enterprise-roll-out-checklist.rst @@ -9,31 +9,34 @@ This checklist is intended to serve as a guide to Enterprises who are rolling ou Checklist overview ------------------- - - `Prepare for the roll out`_ - - - `1. Define the roll out project`_ - - `2. Validate essential security and compliance requirements`_ - - `3. Create development, staging, and production environments`_ - - `4. Configure and customize your Mattermost site`_ - - `5. Test production performance and redundancy`_ - - - `Roll out Mattermost`_ - - - `1. Define your team and channel strategy`_ - - `2. Enable key integrations`_ - - `3. Prepare for user onboarding`_ - - `4. Deploy client apps`_ - - `5. Roll out to groups of users`_ - - `6. Drive adoption`_ - - - `Review the roll out`_ - - - `1. Review project charter success metrics`_ - - `2. Review and analyze usage`_ - - `3. Analyze system performance`_ - - `4. Harden security`_ - - `5. Perform maintenance tasks`_ - +Prepare for the roll out +~~~~~~~~~~~~~~~~~~~~~~~~ + +- `1. Define the roll out project`_ +- `2. Validate essential security and compliance requirements`_ +- `3. Create development, staging, and production environments`_ +- `4. Configure and customize your Mattermost site`_ +- `5. Test production performance and redundancy`_ + +Roll out Mattermost +~~~~~~~~~~~~~~~~~~~~ + +- `1. Define your team and channel strategy`_ +- `2. Enable key integrations`_ +- `3. Prepare for user onboarding`_ +- `4. Deploy client apps`_ +- `5. Roll out to groups of users`_ +- `6. Drive adoption`_ + +Review the roll out +~~~~~~~~~~~~~~~~~~~ + +- `1. Review project charter success metrics`_ +- `2. Review and analyze usage`_ +- `3. Analyze system performance`_ +- `4. Harden security`_ +- `5. Perform maintenance tasks`_ + Checklist details ------------------- @@ -105,8 +108,8 @@ Much of the preparation work is focused on ensuring the environment is deployed - Evaluate external network access requirements - - The `Mattermost Marketplace `__ is a service hosted by Mattermost that functions as a central place to store the current versions of available Mattermost integrations. See `Enable Remote Marketplace `__ documentation for details about required external network access. - - Mattermost supports external GIF providers. See `GIF Commands `__ configuration documentation for details about required external network access. + - The `Mattermost Marketplace `__ is a service hosted by Mattermost that functions as a central place to store the current versions of available Mattermost integrations. See :ref:`Enable Remote Marketplace ` documentation for details about required external network access. + - Mattermost supports external GIF providers. See :ref:`GIF Commands ` configuration documentation for details about required external network access. 3. Create development, staging, and production environments ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/source/getting-started/implementation-plan.rst b/source/getting-started/implementation-plan.rst index 1fc58f2251c..c84a667088d 100644 --- a/source/getting-started/implementation-plan.rst +++ b/source/getting-started/implementation-plan.rst @@ -62,6 +62,7 @@ The following diagram is a high-level illustration of the Mattermost platform an .. image:: ../images/network-diagram.svg :alt: Mattermost network diagram shows how the various system components of the Mattermost platform interact with each other within a network deployment. + :class: bg-white **Reference**: https://docs.mattermost.com/deploy/deployment-overview.html diff --git a/source/guides/contribute-to-documentation.rst b/source/guides/contribute-to-documentation.rst index d2ac2fe696f..59c207efb37 100644 --- a/source/guides/contribute-to-documentation.rst +++ b/source/guides/contribute-to-documentation.rst @@ -1,23 +1,23 @@ Contribute to this documentation ================================ -Mattermost has a diverse community that extends well beyond code contributions. If you're interested in contributing to Mattermost, why not help improve the documentation? Be sure to join the documentation community in `~DWG: Documentation Working Group `__ so we can support and celebrate you! +Mattermost has a diverse community that extends well beyond code contributions. If you're interested in contributing to Mattermost, why not help improve the documentation? Be sure to join the documentation community in `~DWG: Documentation Working Group `_ so we can support and celebrate you! How to get started ------------------ -The fastest way to get started with a documentation contribution is to find something you want to change in the documentation. This might be a typo or broken link, or something more extensive like revising or expanding content. Once you've found a page you want to update, select **Edit** in the top right corner of that page. +The fastest way to get started with a documentation contribution is to find something you want to change in the documentation. This might be a typo or broken link, or something more extensive like revising or expanding content. Once you've found a page you want to update, select the edit option |edit-on-github| located in the top right corner of that page. -.. image:: ../images/edit-on-github.png - :height: 100 +.. |edit-on-github| image:: ../images/edit-on-github.png :alt: Contribute to Mattermost documentation by selecting the Edit option located in the top right corner of any documentation page. + :class: theme-icon First-time contributor? ----------------------- -Start by exploring the `Contribute to Mattermost `__ documentation, specifically the `"You want to help with content" `__ section. +Start by exploring the `Contribute to Mattermost `_ documentation, specifically the `"You want to help with content" `_ section. -In a GitHub pull request, you can make changes as if you were editing code. If you're new to contributing to documentation using pull requests in GitHub, the following `video `__ will help you get started: +In a GitHub pull request, you can make changes as if you were editing code. If you're new to contributing to documentation using pull requests in GitHub, the following `video `_ will help you get started: .. raw:: html @@ -30,9 +30,9 @@ Where to find more information Explore the README links below for details on building and previewing documentation locally for our different documentation repositories: -- `docs.mattermost.com documentation README `__ -- `developers.mattermost.com documentation README `__ -- `api.mattermost.com documentation README `__ -- `handbook.mattermost.com documentation README `__ +- `Mattermost Product Documentation README `_ +- `Mattermost Developer Documentation README `_ +- `Mattermost API Reference README `_ +- `Mattermost Handbook README `_ -Thank you for your support! 💙 If you have any questions, reach out to us in `~DWG: Documentation Working Group `__. +Thank you for your support! 💙 If you have any questions, reach out to us in `DWG: Documentation Working Group `_. diff --git a/source/guides/get-help.rst b/source/guides/get-help.rst index f79f6c395c0..c1d97157ed9 100644 --- a/source/guides/get-help.rst +++ b/source/guides/get-help.rst @@ -11,30 +11,30 @@ Training Documentation ------------- -- `Mattermost product documentation (here) `__ - read information for end users and administrators about deploying, managing, and using Mattermost. -- `Mattermost developer documentation `__ - read information for developer community members about integrating, extending, customizing, and contributing to Mattermost. -- `Mattermost API reference `__ - read information for developer community members about the Mattermost API used by Mattermost clients and third-party applications. +- `Mattermost product documentation `__ - Read information for end users and administrators about deploying, managing, and using Mattermost. +- `Mattermost developer documentation `__ - Read information for developer community members about integrating, extending, customizing, and contributing to Mattermost. +- `Mattermost API reference `__ - Read information for developer community members about the Mattermost API used by Mattermost clients and third-party applications. Help Center ----------- -- `Mattermost Help Center `__ - access frequently asked questions and common troubleshooting tips. +- `Mattermost Help Center `__ - Access frequently asked questions and common troubleshooting tips. Community server ---------------- -- `Mattermost Community server `__ - connect with thousands of contributors, customers, and users to build, share, and learn together. This server is our virtual office and is open to everyone. Please review our `Code of Conduct `__ before participating. +- `Mattermost Community server `__ - Connect with thousands of contributors, customers, and users to build, share, and learn together. This server is our virtual office and is open to everyone. Please review our `Code of Conduct `__ before participating. Mattermost user forums ---------------------- -- `Troubleshooting forum `__ - join our community forum for technical support. Please review our `Code of Conduct `__ before participating. +- `Troubleshooting forum `__ - Join our community forum for technical support. Please review our `Code of Conduct `__ before participating. Feedback -------- -- `Report a bug `__ - report bugs or other issues you encounter when using Mattermost to our development team. -- `Propose a feature `__ - vote for feature proposals or submit your own. +- `Report a bug `__ - Report bugs or other issues you encounter when using Mattermost to our development team. +- `Propose a feature `__ - Vote for feature proposals or submit your own. Professional and enterprise support ----------------------------------- diff --git a/source/images/edit-on-github.png b/source/images/edit-on-github.png index cf54a42c004..15ccc31b893 100644 Binary files a/source/images/edit-on-github.png and b/source/images/edit-on-github.png differ diff --git a/source/install/config-ssl-http2-nginx.rst b/source/install/config-ssl-http2-nginx.rst index fc4bdb7b7f9..43eba0ec28c 100644 --- a/source/install/config-ssl-http2-nginx.rst +++ b/source/install/config-ssl-http2-nginx.rst @@ -262,7 +262,7 @@ How do I setup an NGINX proxy with the Mattermost Docker installation? - "80" - "443" -Why does NGINX fail when installing Gitlab CE with Mattermost on Azure? +Why does NGINX fail when installing GitLab CE with Mattermost on Azure? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You may need to update the Callback URLs for the Application entry of Mattermost inside your GitLab instance. diff --git a/source/install/desktop-msi-installer-and-group-policy-install.rst b/source/install/desktop-msi-installer-and-group-policy-install.rst index 720de31a91b..528933f7b34 100644 --- a/source/install/desktop-msi-installer-and-group-policy-install.rst +++ b/source/install/desktop-msi-installer-and-group-policy-install.rst @@ -17,7 +17,7 @@ Download group policy and MSI installer files .. image:: ../images/desktop/msi_gpo/msi_gpo_installation_test_00001.png :alt: When downloading group policy and MIS installer files, ensure to use a Windows version that supports Edit group policy. -2. Navigate to the `Mattermost Desktop `__ repository on `Github.com `__. +2. Navigate to the `Mattermost Desktop `__ repository on `GitHub.com `__. .. image:: ../images/desktop/msi_gpo/msi_gpo_installation_test_00002.png :alt: Go to the mattermost/desktop repository on GitHub. diff --git a/source/install/install-ubuntu.rst b/source/install/install-ubuntu.rst index fc3b92ac3c7..fd95a376897 100644 --- a/source/install/install-ubuntu.rst +++ b/source/install/install-ubuntu.rst @@ -38,18 +38,32 @@ You can install the Mattermost Server using our ``.deb`` signed packages using t .. tip:: - If you are running the Mattermost Server and database on a single system, we recommend the :doc:`Mattermost Omnibus install method ` as this greatly reduces setup and ongoing maintenance. + - If you are running the Mattermost Server and database on a single system, we recommend the :doc:`Mattermost Omnibus install method ` as this greatly reduces setup and ongoing maintenance. -.. note:: - - You need a PostgreSQL database. See the :doc:`database preparation ` documentation for details on this prerequisite. + - You need a PostgreSQL database. See the :doc:`database preparation ` documentation for details on this prerequisite. A Mattermost deployment includes 4 steps: `add the PPA repository <#add-the-mattermost-server-ppa-repository>`__, `install <#install>`__, `setup <#setup>`__, and `update <#updates>`__. Add the Mattermost Server PPA repository ---------------------------------------- -In a terminal window, run the following command to add the Mattermost Server repositories: +.. important:: + + The GPG public key has changed. You can `import the new public key `_ or run the automatic Mattermost PPA repository setup script provided below. Depending on your setup, additional steps may also be required, particularly for installations that didn't rely on the repository setup script. We recommend deleting the old key from ``/etc/apt/trusted.gpg.d`` before adding the apt repository. + + - For Ubuntu distributions including Bionic and Focal: + + ``sudo rm /usr/share/keyrings/mattermost-archive-keyring.gpg`` + + ``curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/mattermost-archive-keyring.gpg >/dev/null`` + + - For Ubuntu Jammy: + + ``sudo gpg --batch --delete-key A1B31D46F0F3A10B02CF2D44F8F2C31744774B28`` + + ``curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | sudo gpg --import`` + +In a terminal window, run the following repository setup command to add the Mattermost Server repositories: .. raw:: html @@ -69,6 +83,8 @@ In a terminal window, run the following command to add the Mattermost Server rep
+This command configures the repositories needed for a PostgreSQL database, configures an NGINX web server to act as a proxy, configures certbot to issue and renew the SSL certificate, and configures the Mattermost Omnibus repository so that you can run the install command. + Install ------- diff --git a/source/install/installing-mattermost-omnibus.rst b/source/install/installing-mattermost-omnibus.rst index cbd5f793a39..cb3da2b1a20 100644 --- a/source/install/installing-mattermost-omnibus.rst +++ b/source/install/installing-mattermost-omnibus.rst @@ -43,7 +43,23 @@ Mattermost Omnibus packages the free, unlicensed Mattermost Enterprise version o Add the Mattermost PPA repositories ----------------------------------- -In a terminal window, run the following command +.. important:: + + The GPG public key has changed. You can `import the new public key `_ or run the automatic Mattermost PPA repository setup script provided below. Depending on your setup, additional steps may also be required, particularly for installations that didn't rely on the repository setup script. We recommend deleting the old key from ``/etc/apt/trusted.gpg.d`` before adding the apt repository. + + - For Ubuntu distributions including Bionic and Focal: + + ``sudo rm /usr/share/keyrings/mattermost-archive-keyring.gpg`` + + ``curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/mattermost-archive-keyring.gpg >/dev/null`` + + - For Ubuntu Jammy: + + ``sudo gpg --batch --delete-key A1B31D46F0F3A10B02CF2D44F8F2C31744774B28`` + + ``curl -sL -o- https://deb.packages.mattermost.com/pubkey.gpg | sudo gpg --import`` + +In a terminal window, run the following repository setup command: .. raw:: html diff --git a/source/install/software-hardware-requirements.rst b/source/install/software-hardware-requirements.rst index 513f58f2722..0773dfff181 100644 --- a/source/install/software-hardware-requirements.rst +++ b/source/install/software-hardware-requirements.rst @@ -13,6 +13,7 @@ Please see the :doc:`Mattermost Deployment Overview ` to do so. +You can access logs for Mattermost and use them for troubleshooting. These steps assume that you have appropriate :doc:`system admin permissions ` to do so. Mattermost Server logs ---------------------- diff --git a/source/manage/cloud-billing.rst b/source/manage/cloud-billing.rst index 2c9258ddb17..c7d3f5548ce 100644 --- a/source/manage/cloud-billing.rst +++ b/source/manage/cloud-billing.rst @@ -14,7 +14,7 @@ From February 2, 2023, Mattermost Cloud Professional and Enterprise plans are of 2. Fill in your payment information. 3. Select **Switch to annual billing** -To upgrade to a Professional plan within Mattermost, select **View plans** in the header or in the System Console. For Enterprise plans, you need to `contact sales `__. +To upgrade to a Professional plan within Mattermost, select **View plans** in the header or in the System Console. For Enterprise plans, you need to `contact sales `_. When you upgrade, you'll need to indicate the number of user seats you have - these are activated users who'll be using Mattermost. This can't be less than the current total number of activated users in your workspace but you can buy more seats to accommodate active user growth. You'll be billed immediately for the cost of the annual subscription. diff --git a/source/manage/cloud-byok.rst b/source/manage/cloud-byok.rst index 57de32f9499..8ab8f47b4b0 100644 --- a/source/manage/cloud-byok.rst +++ b/source/manage/cloud-byok.rst @@ -70,7 +70,7 @@ Requirements Considerations ~~~~~~~~~~~~~~~~~~~~~~~ -- Changing the AWS KMS key in the database necessitates downtime due to AWS Aurora's encryption `limitations. `__ +- Changing the AWS KMS key in the database necessitates downtime due to AWS Aurora's encryption `limitations. `_ - Proper communication is essential for setting expectations and scheduling changes. Conclusion @@ -78,4 +78,4 @@ Conclusion If you are a large enterprise with compliance requirements, or are working in highly-regulated industries, using Mattermost Cloud Dedicated with BYOK ensures full data control. -For any further assistance or queries, `contact our support team `__. +For any further assistance or queries, `contact our support team `_. diff --git a/source/manage/cloud-ip-filtering.rst b/source/manage/cloud-ip-filtering.rst index d63bf8231d0..3ddf5425a6c 100644 --- a/source/manage/cloud-ip-filtering.rst +++ b/source/manage/cloud-ip-filtering.rst @@ -26,7 +26,7 @@ CIDR (Classless Inter-Domain Routing) notation is used to specify a range of IP .. tip:: - For a more in-depth explanation of CIDR notation, refer to `this article `__. + For a more in-depth explanation of CIDR notation, refer to `this article `_. Configure IP filters ------------------------ @@ -77,7 +77,7 @@ Unable to access your workspace? If you are unable to access your workspace due to previously set IP filters, and you need to regain access to your workspace, your workspace owner can: -1. Log in to the `Mattermost Customer Portal `__. +1. Log in to the `Mattermost Customer Portal `_. 2. Select the **IP Filtering** menu item in the left hand side bar. 3. Select **Disable IP Filtering**. @@ -90,4 +90,4 @@ Conclusion By configuring IP filters using CIDR notation, system admins can effectively manage access to the workspace, enhancing security by allowing access only from specified IP ranges. -For any further assistance or queries, `contact our support team `__. +For any further assistance or queries, `contact our support team `_. diff --git a/source/manage/error-codes.rst b/source/manage/error-codes.rst index efdcebf611f..4a03e15c3da 100644 --- a/source/manage/error-codes.rst +++ b/source/manage/error-codes.rst @@ -17,7 +17,7 @@ ERROR_SAFETY_LIMITS_EXCEEDED This error happens in the free version of Mattermost when more than 10,000 users are registered on the server. -The free version of Mattermost is intended for approximately 50 users, and should a deployment materially exceed this recommended size, administrators should seek to either `purchase a commercial license `__ or apply for a `nonprofit license `__. +The free version of Mattermost is intended for approximately 50 users, and should a deployment materially exceed this recommended size, administrators should seek to either `purchase a commercial license `_ or apply for a :ref:`nonprofit license `. When usage grossly exceeds the recommended limit for users in a safe deployment, an error message is displayed and certain functionality may be limited. diff --git a/source/manage/mmctl-command-line-tool.rst b/source/manage/mmctl-command-line-tool.rst index e105f9f8890..913fb7772de 100644 --- a/source/manage/mmctl-command-line-tool.rst +++ b/source/manage/mmctl-command-line-tool.rst @@ -2105,6 +2105,9 @@ Set the value of a config setting by its name in dot notation. Accepts multiple mmctl config set SqlSettings.DriverName postgres mmctl config set SqlSettings.DataSourceReplicas "replica1" "replica2" + mmctl config set PluginSettings.Plugins.com.mattermost.calls.rtcdserviceurl "http://mattermost-rtcd" + + **Options** diff --git a/source/onboard/bulk-loading-data-format.rst b/source/onboard/bulk-loading-data-format.rst index d54a7cdd8e4..d8c18775eb1 100644 --- a/source/onboard/bulk-loading-data-format.rst +++ b/source/onboard/bulk-loading-data-format.rst @@ -632,7 +632,7 @@ Fields of the User object The authentication data if auth_service is used. The value depends on the auth_service that is specified.
The data comes from the following fields for the respective auth_services:
"" or not provided - must be omitted.
- "gitlab" - The value of the Id attribute provided in the Gitlab auth data.
+ "gitlab" - The value of the Id attribute provided in the GitLab auth data.
"ldap" - The value of the LDAP attribute specified as the "ID Attribute" in the Mattermost LDAP configuration.
"saml" - The value of the SAML Email address attribute.
"google" - The value of the OAuth Id attribute.
diff --git a/source/onboard/sso-saml-onelogin.rst b/source/onboard/sso-saml-onelogin.rst index 8cbf7f3402b..02e8c2f6066 100644 --- a/source/onboard/sso-saml-onelogin.rst +++ b/source/onboard/sso-saml-onelogin.rst @@ -68,7 +68,7 @@ Create a OneLogin connection app for Mattermost SSO Attribute parameters map attributes between OneLogin and Mattermost. For more information on which attributes are configurable, see our :ref:`documentation on SAML configuration settings `. - *Email* attributes are required. For Mattermost servers running version 3.3 and earlier, ``FirstName`` and ``LastName`` attributes are also required. + *Email* attributes are required. a. Select the **Parameters** tab. b. Select **Add Parameter**. @@ -143,8 +143,6 @@ Configure SAML Sign-On for Mattermost The **Email Atttribute** field and the **Username Attribute** field are required, and should match the values that you entered earlier when you configured the SAML Test Connector on OneLogin. - For Mattermost servers running version 3.3 and earlier, ``FirstName`` and ``LastName`` attributes are also required. - .. image:: ../../source/images/okta_13_mattermost_attributes.png :alt: On the System Console SAML page, set attributes for the SAML Assertions used to update user information in Mattermost. Both Email Attribute and Username Attribute are required, and should match the values entered when configuring the SAML Test Connector in OneLogin. diff --git a/source/preferences/customize-desktop-app-experience.rst b/source/preferences/customize-desktop-app-experience.rst index 280b516f409..4c001a96c62 100644 --- a/source/preferences/customize-desktop-app-experience.rst +++ b/source/preferences/customize-desktop-app-experience.rst @@ -12,7 +12,7 @@ Additional customization options are available to you when using the Mattermost .. tab:: Linux - When you :ref: `install the Mattermost desktop app `__, you can access additional Desktop App customization settings from the **More** |more-icon-vertical| icon located in the top left corner of the desktop app by selecting **File > Settings...** + When you :ref:`install the Mattermost desktop app `, you can access additional Desktop App customization settings from the **More** |more-icon-vertical| icon located in the top left corner of the desktop app by selecting **File > Settings...** .. image:: ../images/desktop-app-settings.jpg :alt: Access Desktop App customization settings by selecting More in the top left corner, then selecting File > Settings. @@ -65,7 +65,7 @@ Additional customization options are available to you when using the Mattermost .. tab:: Mac - hen you :ref: `install the Mattermost desktop app `__, you can access additional Desktop App customization settings by selecting **Mattermost > Preferences** from the menu bar. + When you :ref:`install the Mattermost desktop app `, you can access additional Desktop App customization settings by selecting **Mattermost > Preferences** from the menu bar. .. image:: ../images/mac-desktop-app-settings.png :alt: Access Desktop App customization settings by selecting Mattermost from the menu bar, then selecting Preferences. @@ -101,7 +101,7 @@ Additional customization options are available to you when using the Mattermost .. tab:: Windows - hen you :ref: `install the Mattermost desktop app `__, you can access additional Desktop App customization settings from the **More** |more-icon-vertical| icon located in the top left corner of the desktop app by selecting **File > Settings...** + When you :ref:`install the Mattermost desktop app `, you can access additional Desktop App customization settings from the **More** |more-icon-vertical| icon located in the top left corner of the desktop app by selecting **File > Settings...** .. image:: ../images/desktop-app-settings.jpg :alt: Access Desktop App customization settings by selecting More in the top left corner, then selecting File > Settings. diff --git a/source/preferences/manage-advanced-options.rst b/source/preferences/manage-advanced-options.rst index ed698a2e255..32650f7b3a2 100644 --- a/source/preferences/manage-advanced-options.rst +++ b/source/preferences/manage-advanced-options.rst @@ -129,12 +129,12 @@ Delete local files You can delete local Mattermost files from your mobile device using the mobile app. -.. tab:: Mobile +.. tab:: Web/Desktop - Access **Settings** by tapping on your profile picture. Then, tap **Advanced Settings** and **Delete local files**. + This option isn't applicable to the web or desktop app instance of Mattermost. - Only data specific to the current Mattermost server is removed from your device. You'll need to repeat this process for each :doc:`Mattermost workspace you're connected to ` on the mobile app. +.. tab:: Mobile -.. tab:: Web/Desktop + Access **Settings** by tapping on your profile picture. Then, tap **Advanced Settings** and **Delete local files**. - This option isn't applicable to the web or desktop app instance of Mattermost. \ No newline at end of file + Only data specific to the current Mattermost server is removed from your device. You'll need to repeat this process for each :doc:`Mattermost workspace you're connected to ` on the mobile app. \ No newline at end of file diff --git a/source/repeatable-processes/learn-about-playbooks.rst b/source/repeatable-processes/learn-about-playbooks.rst index db6c146aff3..ac7754c27bb 100644 --- a/source/repeatable-processes/learn-about-playbooks.rst +++ b/source/repeatable-processes/learn-about-playbooks.rst @@ -8,10 +8,10 @@ A playbook is a repeatable process that is measured and refined over time. For e Each playbook represents a recurring outcome or specific goal that your teams collaborate on to achieve, such as service outage recovery or customer onboarding. Playbooks are made up of: -- `Checklists `__: The list of tasks to be completed for the run. Can be edited ad-hoc during a run. -- `Templates `__: Used for frequently-used actions such as updates and reminders. You can create your own templates or use default ones. -- `Automation actions `__: Used for inviting members, creating webhooks, editing welcome messages, and more. -- `Permissions `__: Manage permissions at the channel and at the playbook level. +- :ref:`Checklists `: The list of tasks to be completed for the run. Can be edited ad-hoc during a run. +- :ref:`Templates `: Used for frequently-used actions such as updates and reminders. You can create your own templates or use default ones. +- :ref:`Automation actions `: Used for inviting members, creating webhooks, editing welcome messages, and more. +- :doc:`Permissions`: Manage permissions at the channel and at the playbook level. Teams run a playbook every time they want to orchestrate people, tools, and data to achieve that outcome as quickly as possible while providing visibility to stakeholders. diff --git a/source/scale/high-availability-cluster.rst b/source/scale/high-availability-cluster.rst index 5b15cf224a8..f137618396d 100644 --- a/source/scale/high-availability-cluster.rst +++ b/source/scale/high-availability-cluster.rst @@ -39,12 +39,11 @@ To ensure your instance and configuration are compatible with high availability, Back up your Mattermost database and file storage locations before configuring high availability. For more information about backing up, see :doc:`../deploy/backup-disaster-recovery`. -1. Upgrade Mattermost Server to version 4.0 or later. See :doc:`../upgrade/upgrading-mattermost-server`. -2. Set up a new Mattermost server with version 4.0 or later by following one of our **Install Guides**. This server must use an identical copy of the configuration file, ``config.json``. Verify the servers are functioning by hitting each independent server through its private IP address. -3. Modify the ``config.json`` files on both servers to add ``ClusterSettings``. See the :ref:`high availability configuration settings ` documentation for details. -4. Verify the configuration files are identical on both servers then restart each machine in the cluster. -5. Modify your NGINX setup so that it proxies to both servers. For more information about this, see `proxy server configuration`_. -6. Open **System Console > Environment > High Availability** to verify that each machine in the cluster is communicating as expected with green status indicators. If not, investigate the log files for any extra information. +1. Set up a new Mattermost server by following one of our **Install Guides**. This server must use an identical copy of the configuration file, ``config.json``. Verify the servers are functioning by hitting each independent server through its private IP address. +2. Modify the ``config.json`` files on both servers to add ``ClusterSettings``. See the :ref:`high availability configuration settings ` documentation for details. +3. Verify the configuration files are identical on both servers then restart each machine in the cluster. +4. Modify your NGINX setup so that it proxies to both servers. For more information about this, see `proxy server configuration`_. +5. Open **System Console > Environment > High Availability** to verify that each machine in the cluster is communicating as expected with green status indicators. If not, investigate the log files for any extra information. Add a server to the cluster ~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/source/scale/scaling-for-enterprise.rst b/source/scale/scaling-for-enterprise.rst index d6dc0e8c02f..ae66ecc5246 100644 --- a/source/scale/scaling-for-enterprise.rst +++ b/source/scale/scaling-for-enterprise.rst @@ -1,9 +1,6 @@ Scaling for Enterprise ====================== -.. include:: ../_static/badges/allplans-selfhosted.rst - :start-after: :nosearch: - Mattermost is designed to scale from small teams hosted on a single server to large enterprises running in cluster-based, highly available deployment configurations. - Mattermost supports any 64-bit x86 processor architecture diff --git a/source/upgrade/extended-support-release.rst b/source/upgrade/extended-support-release.rst index e9027fb5bb8..b6121a5dd5c 100644 --- a/source/upgrade/extended-support-release.rst +++ b/source/upgrade/extended-support-release.rst @@ -1,7 +1,7 @@ Extended Support Release ======================== -.. include:: ../_static/badges/allplans-selfhosted.rst +.. include:: ../_static/badges/ent-selfhosted.rst :start-after: :nosearch: What is an Extended Support Release? @@ -19,7 +19,7 @@ Mattermost provides an ESR when a significant number of new features and improve When an ESR is at the end of its life cycle, there will be announcements ahead of time to provide time for people to test, certify, and deploy a newer ESR version before support ends. After a release reaches its end-of-life, no further updates will be provided for that version. Please see :doc:`Release Lifecycle documentation ` for a full list of lifecycles for each Mattermost release. -To receive updates about Extended Support Releases, sign up for our mailing list `here `__. +To receive updates about Extended Support Releases, sign up for our mailing list `here `_. .. image:: ../images/ESR2_update.png :alt: Timeline-based chart showing the lifecycle of Mattermost Extended Support Releases and feature releases from last year and this year. @@ -115,8 +115,8 @@ See more details in our :ref:`release lifecycle documentation `_, will we have compatibility issues? -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -No. Your license key is decoupled from the Mattermost server version. You can freely upgrade to any ESR regardless of your license key or plan. +No. Your license key is decoupled from the Mattermost server version. -However, we highly recommend working with your Mattermost Account Team to plan for a migration to our new plans, and to access the latest features such as persistent notifications, advanced compliance features, and call recordings. +We highly recommend working with your Mattermost Account Team to plan for a migration to our new plans, and to access the latest features such as persistent notifications, advanced compliance features, and call recordings. -Please contact our `Sales team `_ with questions. +Please contact our `Sales team `_ with questions. \ No newline at end of file diff --git a/source/upgrade/important-upgrade-notes.rst b/source/upgrade/important-upgrade-notes.rst index fd8b79b31a7..d0ce161e89c 100644 --- a/source/upgrade/important-upgrade-notes.rst +++ b/source/upgrade/important-upgrade-notes.rst @@ -10,6 +10,7 @@ Important Upgrade Notes - Upgrading the Microsoft Teams Calling plugin to v2.0.0 requires users to reconnect their accounts. - When upgrading to 7.x from a 5.x release please make sure to upgrade to 5.37.10 first for the upgrade to complete successfully. - Disable global drafts. Admins can set the feature flag ``MM_FEATUREFLAGS_GLOBALDRAFTS`` to ``false`` to disable server-wide. It can't be disabled on a per-user basis. The code is located `here `__. + - Mattermost plugins built with Go versions 1.22.0 and 1.22.1 do not work. Plugin developers should use go 1.22.2 or newer instead. +----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | If you’re upgrading from a version earlier than... | Then... | @@ -102,7 +103,7 @@ Important Upgrade Notes | | The Channel Export and Apps plugins are now disabled by default. | | +------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | | Apps Bar is now enabled by default for on-prem servers. ``ExperimentalSettings.EnableAppBar`` was also renamed to ``ExperimentalSettings.DisableAppBar``. | -| | See more details at https://docs.mattermost.com/configure/experimental-configuration-settings.html#disable-app-bar and at | +| | See more details at https://docs.mattermost.com/configure/experimental-configuration-settings.html#disable-apps-bar and at | | | https://forum.mattermost.com/t/channel-header-plugin-changes/13551 | | +------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | | In the main `server package`, the Go module path has changed from ``github.com/mattermost/mattermost-server/server/v8`` to | diff --git a/source/upgrade/release-lifecycle.rst b/source/upgrade/release-lifecycle.rst index a87bdd6945c..548f96f5e93 100644 --- a/source/upgrade/release-lifecycle.rst +++ b/source/upgrade/release-lifecycle.rst @@ -13,167 +13,167 @@ During each monthly release, Mattermost backports high severity or high impact s Support for Mattermost Server v8.1 :doc:`Extended Support Release ` is coming to the end of its life cycle on May 15, 2024. Upgrading to Mattermost Server v9.5 or later is recommended. -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| Version | Release Type | Lifecyle Start Date | Lifecycle End Date | Extended Support Release | -+=============+=======================+==========================+==========================+==========================+ -| 9.7 | Feature | 2024-04-16 | 2024-07-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.6 | Feature | 2024-03-16 | 2024-06-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.5 | Feature | 2024-02-16 | 2024-11-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.4 | Feature | 2024-01-16 | 2024-04-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.3 | Feature | 2023-12-16 | 2024-03-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.2 | Feature | 2023-11-16 | 2024-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.1 | Feature | 2023-10-16 | 2024-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 9.0 | Major | 2023-09-16 | 2023-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 8.1 | Feature | 2023-08-16 | 2024-05-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 8.0 | Major | 2023-07-16 | 2023-10-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.10 | Feature | 2023-04-16 | 2023-08-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.9 | Feature | 2023-03-16 | 2023-07-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.8 | Feature | 2023-02-16 | 2023-11-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.7 | Feature | 2023-01-16 | 2023-04-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.5 | Feature | 2022-11-16 | 2023-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.4 | Feature | 2022-10-16 | 2023-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.3 | Feature | 2022-09-16 | 2022-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.2 | Feature | 2022-08-16 | 2022-11-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.1 | Feature | 2022-07-15 | 2023-05-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 7.0 | Major | 2022-06-15 | 2022-09-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.7 | Feature | 2022-05-16 | 2022-08-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.6 | Feature | 2022-04-16 | 2022-07-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.5 | Feature | 2022-03-16 | 2022-06-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.4 | Feature | 2022-02-16 | 2022-05-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.3 | Feature | 2022-01-16 | 2022-10-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.2 | Feature | 2021-12-16 | 2022-03-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.1 | Feature | 2021-11-16 | 2022-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 6.0 | Feature | 2021-10-13 | 2022-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.39 | Quality | 2021-09-16 | 2021-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.38 | Feature | 2021-08-16 | 2021-11-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.37 | Feature | 2021-07-16 | 2022-04-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.36 | Feature | 2021-06-16 | 2021-09-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.35 | Feature | 2021-05-16 | 2021-08-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.34 | Feature | 2021-04-16 | 2021-07-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.33 | Feature | 2021-03-16 | 2021-06-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.32 | Feature | 2021-02-16 | 2021-05-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.31 | Feature | 2021-01-16 | 2021-10-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.30 | Feature | 2020-12-16 | 2021-03-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.29 | Quality | 2020-11-16 | 2021-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.28 | Feature | 2020-10-16 | 2021-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.27 | Quality | 2020-09-16 | 2020-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.26 | Feature | 2020-08-16 | 2020-11-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.25 | Quality | 2020-07-16 | 2021-04-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.24 | Feature | 2020-06-16 | 2020-09-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.23 | Quality | 2020-05-16 | 2020-08-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.22 | Feature | 2020-04-16 | 2020-07-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.21 | Quality | 2020-03-16 | 2020-06-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.20 | Feature | 2020-02-16 | 2020-05-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.19 | Quality | 2020-01-16 | 2020-10-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.18 | Feature | 2019-12-16 | 2020-03-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.17 | Quality | 2019-11-16 | 2020-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.16 | Feature | 2019-10-16 | 2020-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.15 | Quality | 2019-09-16 | 2019-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.14 | Feature | 2019-08-16 | 2019-11-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.13 | Quality | 2019-07-16 | 2019-09-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.12 | Feature | 2019-06-16 | 2019-08-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.11 | Quality | 2019-05-16 | 2019-07-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.10 | Feature | 2019-04-16 | 2019-06-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.9 | Quality | 2019-03-16 | 2020-04-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.8 | Feature | 2019-02-16 | 2019-04-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.7 | Quality | 2019-01-16 | 2019-03-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.6 | Feature | 2018-12-16 | 2019-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.5 | Quality | 2018-11-16 | 2019-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.4 | Feature | 2018-10-16 | 2018-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.3 | Feature | 2018-09-16 | 2018-11-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.2 | Feature | 2018-08-16 | 2018-10-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.1 | Feature | 2018-07-16 | 2018-09-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 5.0 | Feature | 2018-06-16 | 2018-08-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.10 | Feature | 2018-05-16 | 2019-07-15 | Yes | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.9 | Feature | 2018-04-16 | 2018-06-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.8 | Feature | 2018-03-16 | 2018-05-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.7 | Feature | 2018-02-16 | 2018-04-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.6 | Feature | 2018-01-16 | 2018-03-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.5 | Feature | 2017-12-16 | 2018-02-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.4 | Feature | 2017-11-16 | 2018-01-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.3 | Feature | 2017-10-16 | 2017-12-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.2 | Feature | 2017-09-16 | 2017-11-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.1 | Feature | 2017-08-16 | 2017-10-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ -| 4.0 | Feature | 2017-07-16 | 2017-09-15 | | -+-------------+-----------------------+--------------------------+--------------------------+--------------------------+ ++-------------+--------------------------+--------------------------+--------------------------+ +| Version | Release Type | Lifecyle Start Date | Lifecycle End Date | ++=============+==========================+==========================+==========================+ +| 9.7 | Feature | 2024-04-16 | 2024-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.6 | Feature | 2024-03-16 | 2024-06-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.5 | Extended Support Release | 2024-02-16 | 2024-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.4 | Feature | 2024-01-16 | 2024-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.3 | Feature | 2023-12-16 | 2024-03-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.2 | Feature | 2023-11-16 | 2024-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.1 | Feature | 2023-10-16 | 2024-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 9.0 | Major | 2023-09-16 | 2023-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 8.1 | Extended Support Release | 2023-08-16 | 2024-05-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 8.0 | Major | 2023-07-16 | 2023-10-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.10 | Feature | 2023-04-16 | 2023-08-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.9 | Feature | 2023-03-16 | 2023-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.8 | Extended Support Release | 2023-02-16 | 2023-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.7 | Feature | 2023-01-16 | 2023-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.5 | Feature | 2022-11-16 | 2023-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.4 | Feature | 2022-10-16 | 2023-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.3 | Feature | 2022-09-16 | 2022-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.2 | Feature | 2022-08-16 | 2022-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.1 | Extended Support Release | 2022-07-15 | 2023-05-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 7.0 | Major | 2022-06-15 | 2022-09-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.7 | Feature | 2022-05-16 | 2022-08-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.6 | Feature | 2022-04-16 | 2022-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.5 | Feature | 2022-03-16 | 2022-06-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.4 | Feature | 2022-02-16 | 2022-05-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.3 | Extended Support Release | 2022-01-16 | 2022-10-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.2 | Feature | 2021-12-16 | 2022-03-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.1 | Feature | 2021-11-16 | 2022-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 6.0 | Feature | 2021-10-13 | 2022-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.39 | Quality | 2021-09-16 | 2021-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.38 | Feature | 2021-08-16 | 2021-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.37 | Extended Support Release | 2021-07-16 | 2022-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.36 | Feature | 2021-06-16 | 2021-09-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.35 | Feature | 2021-05-16 | 2021-08-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.34 | Feature | 2021-04-16 | 2021-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.33 | Feature | 2021-03-16 | 2021-06-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.32 | Feature | 2021-02-16 | 2021-05-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.31 | Extended Support Release | 2021-01-16 | 2021-10-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.30 | Feature | 2020-12-16 | 2021-03-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.29 | Quality | 2020-11-16 | 2021-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.28 | Feature | 2020-10-16 | 2021-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.27 | Quality | 2020-09-16 | 2020-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.26 | Feature | 2020-08-16 | 2020-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.25 | Extended Support Release | 2020-07-16 | 2021-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.24 | Feature | 2020-06-16 | 2020-09-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.23 | Quality | 2020-05-16 | 2020-08-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.22 | Feature | 2020-04-16 | 2020-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.21 | Quality | 2020-03-16 | 2020-06-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.20 | Feature | 2020-02-16 | 2020-05-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.19 | Extended Support Release | 2020-01-16 | 2020-10-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.18 | Feature | 2019-12-16 | 2020-03-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.17 | Quality | 2019-11-16 | 2020-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.16 | Feature | 2019-10-16 | 2020-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.15 | Quality | 2019-09-16 | 2019-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.14 | Feature | 2019-08-16 | 2019-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.13 | Quality | 2019-07-16 | 2019-09-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.12 | Feature | 2019-06-16 | 2019-08-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.11 | Quality | 2019-05-16 | 2019-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.10 | Feature | 2019-04-16 | 2019-06-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.9 | Extended Support Release | 2019-03-16 | 2020-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.8 | Feature | 2019-02-16 | 2019-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.7 | Quality | 2019-01-16 | 2019-03-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.6 | Feature | 2018-12-16 | 2019-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.5 | Quality | 2018-11-16 | 2019-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.4 | Feature | 2018-10-16 | 2018-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.3 | Feature | 2018-09-16 | 2018-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.2 | Feature | 2018-08-16 | 2018-10-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.1 | Feature | 2018-07-16 | 2018-09-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 5.0 | Feature | 2018-06-16 | 2018-08-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.10 | Extended Support Release | 2018-05-16 | 2019-07-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.9 | Feature | 2018-04-16 | 2018-06-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.8 | Feature | 2018-03-16 | 2018-05-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.7 | Feature | 2018-02-16 | 2018-04-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.6 | Feature | 2018-01-16 | 2018-03-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.5 | Feature | 2017-12-16 | 2018-02-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.4 | Feature | 2017-11-16 | 2018-01-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.3 | Feature | 2017-10-16 | 2017-12-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.2 | Feature | 2017-09-16 | 2017-11-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.1 | Feature | 2017-08-16 | 2017-10-15 | ++-------------+--------------------------+--------------------------+--------------------------+ +| 4.0 | Feature | 2017-07-16 | 2017-09-15 | ++-------------+--------------------------+--------------------------+--------------------------+ Desktop and mobile app compatibility -------------------------------------