Backport network transaction diagnostics and FPI notes to v0.14 node docs
- Vorherrschende Sprache
- TypeScript
- Sterne
- 10
- Forks
- 50
- Ø Merge
- 22 T. 23 Std.
- Gemergte PRs (30 T.)
- 1
Beschreibung
## Problem
The current node source docs are ingested into `docs.miden.xyz` under Core Concepts -> Node, but released version snapshots in the docs repo are checked in under `versioned_docs/` and do not update automatically when the source node docs change.
The v0.14 node docs snapshot already appears stale in at least one network transaction area:
- current ingested node docs describe `GetNetworkNoteStatus`,
- `versioned_docs/version-0.14/core-concepts/node/operator/architecture.md` still refers to `GetNoteError`,
- `versioned_docs/version-0.14/core-concepts/node/rpc.md` still documents `GetNoteError`,
- `GetNetworkNoteStatus` is the current endpoint that returns lifecycle status, last error, attempt count, and last attempt block.
If the node docs are updated to clarify FPI behavior during network transaction execution, the same clarification should also be backported into the v0.14 versioned docs when it applies to v0.14.
## Why this matters
Developers using versioned docs for v0.14 should not see stale network transaction debugging instructions. This is especially important for Pioneer teams debugging network notes, where the old feedback was that notes simply remained committed without useful error feedback.
Docs search and Docs AI may also surface versioned pages. If those pages still mention `GetNoteError` or omit the network transaction FPI behavior, users can get the wrong mental model even after the current docs are fixed.
## Proposed scope
Patch the docs repo's v0.14 snapshot directly:
- update `versioned_docs/version-0.14/core-concepts/node/operator/architecture.md` to reference `GetNetworkNoteStatus`,
- update `versioned_docs/version-0.14/core-concepts/node/rpc.md` to document `GetNetworkNoteStatus` instead of `GetNoteError`,
- if the node source docs add a short section on FPI in network transactions, backport the same version-appropriate wording into the v0.14 node snapshot,
- avoid editing `docs/core-concepts/node/*` directly unless it is generated from the node repo during the ingest workflow,
- cross-link the versioned node docs with the MASM/network-account tutorial work where appropriate.
## Acceptance criteria
- v0.14 versioned node docs no longer refer users to the old `GetNoteError` endpoint.
- v0.14 versioned node docs describe `GetNetworkNoteStatus` fields accurately.
- Any FPI-in-network-transactions clarification added to node source docs is reflected in the v0.14 snapshot if the behavior exists in v0.14.
- Current docs and versioned docs do not contradict each other on network note diagnostics.
- The docs change is linked to the node source-doc/test work and the MASM network account tutorial issue.
## Related context
- Pioneer feedback from Zoro via Domi.
- `0xMiden/node#1598`
- `0xMiden/node#1758`
- `0xMiden/node#1818`
- `0xMiden/tutorials#193`
- Local node draft: `issue-08-network-tx-fpi-runtime.md`
Beitragsleitfaden
Rechercherichtung
The files to update are `versioned_docs/version-0.14/core-concepts/node/operator/architecture.md` and `versioned_docs/version-0.14/core-concepts/node/rpc.md`. First, read the current node source docs to understand the `GetNetworkNoteStatus` endpoint and its fields. Then, replace references to `GetNoteError` with `GetNetworkNoteStatus` in the specified files, ensuring the description matches the v0.14 behavior. Check for any FPI (Failed Proof Invocation) clarifications in the node source docs to backport. Verify the changes do not conflict with the main docs.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- markdown, typescript
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Ruhig
- Klarheit
- Klar beschrieben
- Anfängerfreundlichkeit
- 70/100