Skip to content

docs(community-management): add Session, Matrix, and SimpleX guides - #607

Merged
mattaereal merged 1 commit into
security-alliance:developfrom
AllyPry:content/session-matrix-simplex-guides
Aug 31, 2026
Merged

mattaereal merged 1 commit into
security-alliance:developfrom
AllyPry:content/session-matrix-simplex-guides

Conversation

@AllyPry

@AllyPry AllyPry commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

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):

Page Focus
guides/account-management/session.mdx Recovery password custody, privacy toggles, Account ID verification, Community server limits
guides/account-management/matrix.mdx Recovery key setup, cross-signing, room configuration, federated moderation, homeserver operations
guides/account-management/simplex.mdx Database passphrase, SimpleX Lock, encrypted backups, connection hygiene, group roles

Community management hubs (framework pages, modelled on community-management/telegram.mdx):

Page Focus
community-management/session.mdx Threat model, risk table, topic index into the Session guide
community-management/matrix.mdx Threat model, risk table, topic index into the Matrix guide
community-management/simplex.mdx Threat model, risk table, topic index into the SimpleX guide

Navigation and supporting changes:

  • vocs.config.ts: three entries under Community Management, three under Guides → Account Management (alphabetical
    position preserved)
  • Page maps updated in community-management/overview.mdx and guides/account-management/overview.mdx
  • Regenerated index.mdx for both touched folders
  • wordlist.txt: added Draupnir, Mjolnir, Orbot, SOGS, XFTP
  • Fixed a pre-existing MD022 markdownlint failure in guides/account-management/overview.mdx (missing blank line
    between 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:

  • Session removes phone numbers and central accounts, which also removes recovery and revocation. The recovery
    password is the account, and Communities running on a Session Open Group Server are not end-to-end encrypted.
  • Matrix is federated, so room membership is a data-distribution decision: every homeserver with a member in a room
    holds a copy of it. Encryption is per room and per device, which makes cross-signing an operational control rather
    than a nicety.
  • SimpleX has no user identifiers at all. The invitation link is the access control and the local database is the
    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 → Encryption rename), the pages say so and
point to the vendor documentation for current paths.

Validation

  • cspell — 27 files checked, 0 issues
  • markdownlint-cli2 — 0 issues
  • validate:content — 7/7 pages in community-management, 18/18 in guides/account-management
  • docs:build — clean, 887 files generated
  • Internal links and heading anchors verified against the built HTML; every cross-link between hub and guide resolves

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
@github-actions

Copy link
Copy Markdown

Sidebar Configuration Reminder

This PR includes added, renamed, or removed documentation files:

  • docs/pages/community-management/matrix.mdx (added)
  • docs/pages/community-management/session.mdx (added)
  • docs/pages/community-management/simplex.mdx (added)
  • docs/pages/guides/account-management/matrix.mdx (added)
  • docs/pages/guides/account-management/session.mdx (added)
  • docs/pages/guides/account-management/simplex.mdx (added)

Please ensure that:

  • The sidebar in vocs.config.ts has been updated to include these files
  • New content has the dev: true parameter so it's marked as under development
  • Sidebar links match the file paths - use the preview deployment to verify

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.

@github-actions

github-actions Bot commented Aug 27, 2026 •

Copy link
Copy Markdown
built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
frameworks ✅ Ready (View Log) Visit Preview e6689f3

@scode2277
scode2277 requested a review from NFTDreww August 27, 2026 12:57
@scode2277 scode2277 added the content:add This issue or PR adds content or suggests to label Aug 27, 2026

@NFTDreww NFTDreww left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did a review, very well written, and aligns with the format of the rest of the documents, and guides.

I'm wondering if this belongs in Community Management long term but it can start here.

@scode2277 scode2277 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Very good job @AllyPry, thanks for this contribution!! And thanks @NFTDreww for the review!

gtg @mattaereal!

@AllyPry

AllyPry commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

TY @NFTDreww and @scode2277 much appreciated

@frameworks-volunteer frameworks-volunteer left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Model: x-ai/grok-4.5 Reasoning: high Provider: openrouter

Security

  • Docs-only change (MDX + vocs.config.ts + wordlist.txt). No secrets, tokens, eval, or XSS vectors.
  • External links point at vendor docs (Session, Element/Matrix.org, SimpleX). No suspicious deps.

QA

  • Two-layer pattern matches existing Telegram/Signal: community hub (threat model + topic index) → account-management guide (checklists).
  • Cross-links and heading anchors line up (recovery/cross-signing, SOGS/E2EE split, SimpleX link rotation, etc.).
  • Sidebar (vocs.config.ts), both overviews, and folder index.mdx files updated; wordlist covers Draupnir/Mjolnir/Orbot/SOGS/XFTP.
  • CI green: lint, Build Preview, sidebar-reminder, Socket.

Nits (non-blocking)

  • guides/account-management/overview.mdx page description still lists older platforms only; body list is updated.
  • reviewed / fact-checked frontmatter left empty (fine for external contrib; maintainers can fill on merge).

LGTM. Approving.

@mattaereal
mattaereal merged commit 7207887 into security-alliance:develop Aug 31, 2026
5 checks passed

This branch was successfully deployed

1 active deployment
Preview — e6689f32 Deployed Aug 27, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:add This issue or PR adds content or suggests to

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Content(add): Session, Matrix, and SimpleX guides for Community Management

5 participants