docs(community-management): add Session, Matrix, and SimpleX guides - #607
Open
AllyPry wants to merge 1 commit into
Open
docs(community-management): add Session, Matrix, and SimpleX guides#607AllyPry wants to merge 1 commit into
AllyPry wants to merge 1 commit into
Conversation
Add account-management guides and community-management framework pages for Session, Matrix, and SimpleX, following the two-layer structure already used for Discord, Telegram, and X. Settings paths and platform behaviours are sourced from vendor documentation and linked under Further reading on each page. Closes security-alliance#599
Sidebar Configuration ReminderThis PR includes added, renamed, or removed documentation files:
Please ensure that:
See Contributing Guide – Sidebar & Navigation for more details. This is an automated reminder. If this PR doesn't need sidebar changes, you can ignore this message. |
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
Adds security documentation for three privacy-focused messaging platforms — Session, Matrix, and SimpleX — following
the two-layer structure already used for Discord, Telegram, and X.
Closes #599.
What this adds
Account management guides (procedure pages, modelled on
signal.mdx):guides/account-management/session.mdxguides/account-management/matrix.mdxguides/account-management/simplex.mdxCommunity management hubs (framework pages, modelled on
community-management/telegram.mdx):community-management/session.mdxcommunity-management/matrix.mdxcommunity-management/simplex.mdxNavigation and supporting changes:
vocs.config.ts: three entries under Community Management, three under Guides → Account Management (alphabeticalposition preserved)
community-management/overview.mdxandguides/account-management/overview.mdxindex.mdxfor both touched folderswordlist.txt: addedDraupnir,Mjolnir,Orbot,SOGS,XFTPMD022markdownlint failure inguides/account-management/overview.mdx(missing blank linebetween two adjacent headings)
Why the platform-specific angle
Each platform is covered on its own terms rather than as a variation on Signal, because the failure modes differ:
password is the account, and Communities running on a Session Open Group Server are not end-to-end encrypted.
holds a copy of it. Encryption is per room and per device, which makes cross-signing an operational control rather
than a nicety.
identity, so backup discipline and link rotation replace the account-recovery and ban primitives operators expect.
Sourcing
Settings paths and platform behaviours were taken from vendor documentation rather than from memory, and each page
links its sources under Further reading: Session Docs and the Session security blog, Element documentation and the
Matrix.org moderation guide, and the SimpleX privacy, app settings, and groups guides. Where client UI labels differ
between platforms or releases (notably Element's
Security & Privacy→Encryptionrename), the pages say so andpoint to the vendor documentation for current paths.
Validation
cspell— 27 files checked, 0 issuesmarkdownlint-cli2— 0 issuesvalidate:content— 7/7 pages incommunity-management, 18/18 inguides/account-managementdocs:build— clean, 887 files generated