Skip to content

docs: rotate documentation for 2642 distribution - #3628

Draft
jpraynaud wants to merge 5 commits into
mainfrom
jpraynaud/3498-rotate-doc-distribution-2642
Draft

jpraynaud wants to merge 5 commits into
mainfrom
jpraynaud/3498-rotate-doc-distribution-2642

Conversation

@jpraynaud

@jpraynaud jpraynaud commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

Content

This PR includes the rotation of the documentation with the release of the new 2642 distribution.

Pre-submit checklist

  • Branch
    • Commit sequence broadly makes sense
    • Key commits have useful messages
  • PR
    • All check jobs of the CI have succeeded
    • Self-reviewed the diff
    • Useful pull request description
    • Reviewer requested

Issue(s)

Relates to #3498

@jpraynaud jpraynaud self-assigned this Oct 14, 2026
Copilot AI lite review requested due to automatic review settings October 14, 2026 16:05

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

Documentation inaccuracies and invalid or incomplete examples remain unresolved.

3 open findings
What changed in this PR

This PR rotates the maintained documentation for the 2642 distribution.

Changes:

  • Documents protocol configuration and SNARK aggregation.
  • Updates operator, signer, client, and aggregator guides.
  • Refreshes network metadata, glossary, navigation, and OpenAPI documentation.
File Summary
docs/​website/​versioned_sidebars/​version-maintained-sidebars.json Reformats sidebar entries.
docs/​website/​versioned_docs/​version-maintained/​networks-matrix.md Updates network configuration details; retain the newer update date.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​threat-model.md Documents protocol configuration security.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​security.md Adjusts sidebar ordering.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​README.mdx Describes aggregation flavors.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​protocol.md Updates protocol setup; make circuit-key requirements SNARK-specific.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​certificates.md Documents certificate chains and caching.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​aggregation/​recursive-snark.md Adds recursive SNARK documentation.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​aggregation/​README.mdx Adds aggregation overview.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​aggregation/​non-recursive-snark.md Adds non-recursive SNARK documentation; correct Merkle leaf contents.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​aggregation/​concatenation.md Adds concatenation documentation.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-protocol/​aggregation/​_category_.json Adds aggregation navigation metadata.
docs/​website/​versioned_docs/​version-maintained/​mithril/​advanced/​mithril-network/​signer.md Clarifies protocol parameter retrieval for newer signers.
docs/​website/​versioned_docs/​version-maintained/​manual/​operate/​run-signer-node.md Documents protocol configuration setup; corrects version wording.
docs/​website/​versioned_docs/​version-maintained/​manual/​operate/​run-aggregator-node.md Updates aggregator configuration; fix unavailable production configuration files.
docs/​website/​versioned_docs/​version-maintained/​manual/​develop/​nodes/​mithril-client.md Documents client cache options.
docs/​website/​versioned_docs/​version-maintained/​manual/​develop/​nodes/​mithril-client-library.md Documents library caching; use the non-deprecated builder API.
docs/​website/​versioned_docs/​version-maintained/​manual/​develop/​nodes/​mithril-client-library-wasm.md Documents WASM caching; initialize the broadcast channel in the example.
docs/​website/​versioned_docs/​version-maintained/​manual/​develop/​nodes/​mithril-aggregator.md Updates commands and configuration; correct help, option, environment, and grammar issues.
docs/​website/​versioned_docs/​version-maintained/​glossary.md Adds IVC, Merkle tree, and SNARK definitions.
docs/​website/​openapi.current.yaml Updates API version and schemas.

🧠 Review effort: Lite


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/website/versioned_docs/version-maintained/manual/operate/run-signer-node.md Outdated
Comment thread docs/website/versioned_docs/version-maintained/networks-matrix.md Outdated
@jpraynaud
jpraynaud marked this pull request as draft October 14, 2026 16:17
@jpraynaud jpraynaud added the do-not-merge 🔒 Do not merge label Oct 14, 2026
@github-actions

github-actions Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Test Results

     5 files  ±0     226 suites  ±0   44m 10s ⏱️ - 18m 9s
 3 998 tests ±0   3 998 ✅ ±0  0 💤 ±0  0 ❌ ±0 
12 635 runs  ±0  12 635 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit fc7e388. ± Comparison against base commit b7a1e69.

♻️ This comment has been updated with latest results.

@jpraynaud
jpraynaud deployed to testing-preview October 14, 2026 16:36 — with GitHub Actions Active
@jpraynaud
jpraynaud deployed to testing-2-preview October 14, 2026 16:36 — with GitHub Actions Active

@damrobi damrobi 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.

LGTM 👍

@jpraynaud
jpraynaud force-pushed the jpraynaud/3498-rotate-doc-distribution-2642 branch from d1afb18 to fc7e388 Compare October 15, 2026 15:24
@jpraynaud
jpraynaud deployed to testing-2-preview October 15, 2026 15:39 — with GitHub Actions Active
@jpraynaud
jpraynaud deployed to testing-preview October 15, 2026 15:39 — with GitHub Actions Active

This branch was successfully deployed

2 active deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge 🔒 Do not merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants