docs(website): harmonize the DMQ beta status across the documentation - #3476
docs(website): harmonize the DMQ beta status across the documentation#3476jpraynaud wants to merge 9 commits into
Conversation
There was a problem hiding this comment.
Pull request overview
This PR updates the Mithril website documentation to consistently reflect the DMQ node’s beta status and aligns the operator guides’ examples and parameters to the release-mainnet network (including updating referenced minimum Cardano node versions).
Changes:
- Harmonize DMQ maturity wording across network matrix, operate guides, and dev blog posts (moving away from “unstable” where applicable).
- Switch operate-guide example values/endpoints from
release-preprod/preprodtorelease-mainnet/mainnet, and fix DMQ bootstrap/service examples. - Update release notes/blog program updates to reflect the DMQ beta rollout on release networks.
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/website/versioned_docs/version-maintained/networks-matrix.md | Marks DMQ status as Beta for testing-preview in the maintained docs. |
| docs/website/versioned_docs/version-maintained/manual/operate/run-signer-node.md | Updates DMQ beta wording and switches examples to release-mainnet parameters (maintained docs). |
| docs/website/versioned_docs/version-maintained/manual/operate/run-aggregator-node.md | Updates DMQ beta wording, switches examples to release-mainnet, and adjusts DMQ/systemd examples (maintained docs). |
| docs/website/root/networks-matrix.md | Marks DMQ status as Beta for testing-preview in the root docs. |
| docs/website/root/manual/operate/run-signer-node.md | Updates DMQ beta wording and switches examples to release-mainnet parameters (root docs). |
| docs/website/root/manual/operate/run-aggregator-node.md | Updates DMQ beta wording, switches examples to release-mainnet, and adjusts DMQ/systemd examples (root docs). |
| docs/website/blog/2026-08-04-dmq-beta-release.md | Aligns wording to “beta” (removes “stable (beta)”) and references updated setup anchor. |
| docs/website/blog/2026-08-03-distribution-2630.md | Aligns distribution notes to “Promoted … to beta”. |
| docs/website/blog/2026-01-06-multiple-aggregators-testing-program.md | Adds a 2026/08/04 update and clarifies rollout plan wording/scope. |
| docs/website/blog/2026-01-06-dmq-testing-program.md | Updates 2026/08/04 update content and fixes the DMQ setup guide anchor reference. |
Suppressed comments (2)
docs/website/root/manual/operate/run-aggregator-node.md:430
- The
/opt/mithril/mithril-aggregator.envexample setsNETWORK_MAGICeven though the guide states it’s only required for non-default networks. Consider removing it from the mainnet example env file snippet to match the documented behavior.
STORE_RETENTION_LIMIT=5
NETWORK=mainnet
NETWORK_MAGIC=764824073
CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket
docs/website/versioned_docs/version-maintained/manual/operate/run-aggregator-node.md:430
- The
/opt/mithril/mithril-aggregator.envexample setsNETWORK_MAGICeven though the guide states it’s only required for non-default networks. Consider removing it from the mainnet example env file snippet to match the documented behavior.
STORE_RETENTION_LIMIT=5
NETWORK=mainnet
NETWORK_MAGIC=764824073
CARDANO_NODE_SOCKET_PATH=/cardano/ipc/node.socket
| - **STORE_RETENTION_LIMIT**: `5` | ||
| - **NETWORK**: `preprod` | ||
| - **NETWORK_MAGIC**: `1` | ||
| - **NETWORK**: `mainnet` | ||
| - **NETWORK_MAGIC**: `764824073` | ||
| - **CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` |
| - **STORE_RETENTION_LIMIT**: `5` | ||
| - **NETWORK**: `preprod` | ||
| - **NETWORK_MAGIC**: `1` | ||
| - **NETWORK**: `mainnet` | ||
| - **NETWORK_MAGIC**: `764824073` | ||
| - **CARDANO_NODE_SOCKET_PATH**: `/cardano/ipc/node.socket` |
Test Results 5 files ± 0 209 suites ±0 57m 11s ⏱️ - 1h 39m 27s Results for commit 21d258d. ± Comparison against base commit 084c534. This pull request removes 76 tests. |
Align the `testing-preview` DMQ status with the other Mithril networks, which all run the DMQ node version `0.7.0.0`.
The aggregator guide still announced an unstable DMQ protocol and the signer guide referred to a warning that no longer exists.
…ides The DMQ node is now available on the release networks and uses the same binary version everywhere.
…guide Use the bootstrap peer port of the networks matrix and restore the blank line missing before the systemd install section.
Replace the ambiguous 'stable (beta)' wording with 'beta' and fix the outdated anchor of the DMQ node setup guide.
Add the DMQ beta release update and clarify that the rollout plan is the one of the multiple aggregators feature.
Use the `release-mainnet` parameters in all the example sets, including the DMQ node setup which illustrated the `pre-release-preview` network.
…guide Use the minimum version supported on mainnet declared in `networks.json`.
Replace the `Debug` trace severity with `Info` in the DMQ node configuration examples.
21d258d to
697f3d5
Compare
Content
This PR includes fixes for the inconsistencies about the beta status of the DMQ node across the website, and aligns the operate guides examples on the
release-mainnetnetwork:Betafor thetesting-previewnetwork in the networks matrixpre-release-previewrelease-mainnetparametersnetworks.json.Pre-submit checklist