Skip to content

Rewrite the xchat cryptography primer#273

Merged
santiagomed merged 1 commit into
xdevplatform:mainfrom
alazzaretti:improve-crypto-primer-language
Jul 20, 2026
Merged

Rewrite the xchat cryptography primer#273
santiagomed merged 1 commit into
xdevplatform:mainfrom
alazzaretti:improve-crypto-primer-language

Conversation

@alazzaretti

Copy link
Copy Markdown
Contributor

Rewrites /xchat/cryptography-primer for clarity and accuracy.

  • Restructures the page around the lifecycle of the keys (account creation, conversation creation, messaging, signing), with a worked example of creating a group.
  • Uses plain language in the body; the exact schemes (ECIES, ECDH, ECDSA, P-256) live in the glossary.
  • Expands secure key backup: names the open-source Juicebox protocol, describes the 2-of-3 realm topology with two HSM-backed realms and the 20-attempt guess limit with share deletion, and notes that every recovery path goes through an HSM.
  • States security properties together with the assumptions they rest on, and states the limitations (metadata, no forward secrecy, deliberate rather than automatic post-compromise recovery) plainly, with reasons.

Tested locally with mint dev: page renders, and all internal links and anchors were verified.

Restructure the page around the lifecycle of the keys (account creation,
conversation creation, messaging, signing) with a worked example, and use
plain language in the body; exact schemes (ECIES, ECDH, ECDSA, P-256) live
in the glossary. Expand secure key backup: the open-source Juicebox
protocol by name, the 2-of-3 realm topology with two HSM-backed realms,
and the 20-attempt guess limit with share deletion. State security
properties with their assumptions and the limitations plainly, with
reasons.
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@santiagomed
santiagomed merged commit 15e1c43 into xdevplatform:main Jul 20, 2026
1 check was pending
@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Docs PR opened: #276

Rewrote the X Chat cryptography primer's title and description to be more specific, descriptive, and SEO-friendly.

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Docs PR opened: #277

Updated the cryptography primer's title and sidebar title from title case to sentence case for consistency with sibling pages.

Note: failed to automatically merge

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Docs PR opened: #278

Translated the rewritten X Chat cryptography primer into Japanese, Spanish, Portuguese, and Korean.

@alazzaretti
alazzaretti deleted the improve-crypto-primer-language branch July 22, 2026 00:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants