Desktop v6.1.0 Docs #8735
Open
Desktop v6.1.0 Docs #8735
+229
−32
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
* Docs: Add Sentry error reporting documentation for Desktop v6.1.0 Add comprehensive documentation for the new Sentry error reporting feature introduced in Mattermost Desktop v6.1.0 across all relevant personas: End User documentation: - Updated customize-desktop-app-experience.rst to document the new "Send error reports to help improve the app" setting in Advanced section - Added details about what data is collected, privacy protections, and restart requirement System Admin documentation: - Updated desktop-app-deployment.rst with Privacy and data handling section - Documented default behavior, data collection details, and organizational considerations for admins - Added guidance for organizations with restrictive data policies Risk Assessor documentation: - Created new desktop-app-privacy.rst with comprehensive privacy and compliance information - Documented data collection scope, PII exclusions, and technical controls - Included compliance considerations for GDPR, data residency, and consent - Added audit and verification guidance Troubleshooting: - Updated desktop-troubleshooting.rst with error reporting context - Added step-by-step instructions to disable error reporting - Documented what data is and isn't collected Related to mattermost/desktop#3610 Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com> * Remove build flag references from deployment docs Per review feedback, removed point 3 about build-time control with MM_DESKTOP_BUILD_SENTRYDSN from deployment docs. This information is more appropriately detailed in the desktop-app-privacy.rst file. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Consolidate privacy docs into deployment guide Remove separate desktop-app-privacy.rst and consolidate relevant information into desktop-app-deployment.rst with simplified, focused content on what data is/isn't sent. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Remove error reporting section from troubleshooting docs Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Editorial reviews --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com> Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com>
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA a9f71ed |
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA ff618cb |
* Docs: Add Flatpak support for Mattermost Desktop v6.1.0 - Add new Flatpak tab to Linux desktop installation guide with detailed installation instructions for x86_64 and aarch64 architectures - Document Flatpak runtime requirements (Freedesktop Platform/SDK 25.08, Electron BaseApp 25.08) in software requirements - Add Flatpak availability note to desktop app deployment guide - Mark Flatpak as beta per release evidence - Include considerations for sandboxed environment and Wayland support Addresses issue #8716 Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> * Apply suggestion from @devinbinnie Co-authored-by: Devin Binnie <52460000+devinbinnie@users.noreply.github.com> * Editorial updates --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> Co-authored-by: Carrie Warner (Mattermost) <74422101+cwarnermm@users.noreply.github.com> Co-authored-by: Devin Binnie <52460000+devinbinnie@users.noreply.github.com>
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA 28d26bd |
…e EXE for icon in shortcuts (#8719) * docs: Document Desktop v6.1.0 Windows MSI shortcut handling changes Update documentation across End User, System Admin, and IT Operations guides to reflect the Windows MSI installer shortcut handling changes introduced in Desktop v6.1.0. Changes include: - End User: Added upgrade notes and shortcut recreation steps - System Admin: Added deployment planning and Windows distribution context - IT Operations: Added troubleshooting guidance and rollout planning Related to mattermost/desktop#3648 Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> * Update source/end-user-guide/access/install-desktop-app.rst Co-authored-by: Devin Binnie <52460000+devinbinnie@users.noreply.github.com> * docs: Streamline Desktop v6.1.0 shortcut documentation Reduce repetitive taskbar shortcut recreation guidance across documentation files. Detailed technical background will be covered in the changelog. Changes: - End user guide: Remove lengthy explanations, keep essential steps - MSI installer guide: Brief deployment planning consideration only - Troubleshooting: Concise symptom/scope/solution format - Desktop deployment: Clarify Windows Store recommendation Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com> * docs: Clarify Windows Store deployment uses InTune for organizations Updated Windows Store option to specify that organizations deploy through InTune for centralized management, replacing outdated SCCM/Windows Store for Business reference. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * docs: Remove repetitive distribution options from MSI guide, clarify InTune deployment - Removed 'Windows distribution options' section from MSI installer guide - Content was duplicated from desktop-app-deployment.rst - Clarified that Windows Store for organizations deploys through InTune - Kept MSI-specific upgrade note in MSI guide Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * docs: Remove repetitive v6.1.0 upgrade content from end-user guide All detail about the Windows MSI shortcut issue is already covered in the troubleshooting section. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * docs: Remove repetitive v6.1.0 upgrade content from MSI guide Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * docs: Revert changes to all files except troubleshooting.rst Remove v6.1.0 upgrade documentation from end-user guide, MSI installer guide, and deployment guide. Keep only the troubleshooting entry as the single source of truth for the Windows MSI shortcut issue. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * docs: Revert whitespace-only changes to keep only troubleshooting.rst content Reverted trailing whitespace removal and newline additions from three files to ensure only the v6.1.0 troubleshooting section remains as the change. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Editorial reviews * Editorial updates --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Combs7th <Combs7th@users.noreply.github.com> Co-authored-by: Carrie Warner (Mattermost) <74422101+cwarnermm@users.noreply.github.com> Co-authored-by: Devin Binnie <52460000+devinbinnie@users.noreply.github.com> Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com> Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com>
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA a8bca9d |
* Docs: Document Desktop v6.1.0 per-machine MSI installation changes From Mattermost Desktop v6.1.0, the Windows MSI installer defaults to per-machine (system-wide) installation to meet enterprise compliance requirements. This changes installation behavior and upgrade paths. Updates include: - End-user upgrade guidance with two distinct scenarios (<v5.9 and v5.9-v6.0.4) - System admin deployment considerations and support planning - Troubleshooting for v6.1.0 upgrade issues - System requirements noting admin privileges requirement Key changes documented: - New default install location: C:\Program Files\Mattermost - Registry keys now in HKLM instead of HKCU - Shortcuts in Public folder for all users - Manual uninstall required for v5.9-v6.0.4 per-user installs before upgrading Addresses issue #8722 Relates to desktop PR mattermost/desktop#3659 Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com> * Remove AI-generated content sections from deployment guide Remove Standardization benefits, Risk assessment, and Compliance verification sections as they contain repetitive AI-generated content that doesn't provide additional value. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Clarify GitHub release download instructions Specify to expand the Assets dropdown and download 'Source code (zip)' Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Remove 32-bit references from desktop MSI installer documentation Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Remove obsolete note about ALLUSERS parameter from v6.1.0 section Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Remove repetitive v6.1.0 upgrade instructions from install guide Removed the detailed 'Upgrade to v6.1.0 (Windows MSI)' section from the end-user installation guide as this information is already documented in the troubleshooting guide. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Simplify v6.1.0 deployment considerations section Reduced verbose content to essential 2 paragraphs covering: - Per-machine installation default for enterprise compliance - Technical details (Program Files location, HKLM registry, admin privileges) - Link to troubleshooting guide for v5.9-v6.0.4 upgrade path Removed AI-generated content including deployment templates, risk assessments, and support readiness sections that were repetitive. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Add bookmark anchor to troubleshooting guide link Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Fix troubleshooting guide link with bookmark anchor Use direct HTML anchor link format instead of :ref: directive to properly link to the upgrade troubleshooting section. Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com> * Editorial reviews --------- Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com> Co-authored-by: Carrie Warner (Mattermost) <cwarnermm@users.noreply.github.com> Co-authored-by: Devin Binnie <devinbinnie@users.noreply.github.com>
Contributor
|
Newest code from mattermost has been published to preview environment for Git SHA ce5edbc |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.