docs: refresh authored content to v0.16 (next; no version cut) - #368
docs: refresh authored content to v0.16 (next; no version cut)#3680xrouss-miden wants to merge 10 commits into
Conversation
Update the authored onboarding path, setup instructions, account and note flows, storage examples, first-contract walkthrough, FAQ, and landing-page guidance for the v0.16 APIs and toolchain.
Align the authored smart-contract reference with the v0.16 account, note, transaction, standards, MASM, and Rust SDK surfaces.
Refresh the locally authored Web and React SDK guides, signer and lifecycle patterns, transaction flows, setup guidance, and local-node integration for the v0.16 SDK line.
Bring Midenup, Playground, and the locally maintained tutorial helper pages in line with the v0.16 toolchain and developer workflows.
Update llms.txt and the bundled Miden skill with the current repository split, v0.16 stable guidance, and v0.17 next-version context.
Pin the live Guardian documentation ingest and its generated source links to the tested v0.17.0-rc.1 release.
Update setup, smart-contract, client SDK, and tutorial guidance; add transaction fee documentation and pin Guardian ingestion to v0.17.0.
Avoid destructive clear-config instructions for configuration switching and migration. State the published toolchain prerequisite before users attempt the v0.16 testnet guides.
Use the supported import path in the published React SDK 0.16.0 and make matching authentication and available account-state requirements explicit.
Wait for a selected public funding note and its transaction confirmation before minting, consuming, or sending. Resolve refreshed account state by ID after bootstrap.
BrianSeong99
left a comment
There was a problem hiding this comment.
Reviewed the v0.16 content refresh and pushed the remaining onboarding fixes: non-destructive configuration guidance, existing-account imports for external signers, and confirmed native-fee funding before example transactions.
Validation passed: full docs build, strict checks for all 15 extracted TS/TSX blocks, five Rust binaries plus the funding helper, and all five funding regression tests. No broken links or anchors originate from /next.
Approving the content changes. The documented coherent v0.16 testnet toolchain prerequisite still needs release coordination; this is not live-network validation. Repository-wide typecheck failures outside this patch and stable/historical link warnings remain. Snapshot work is separate.
Summary
Refreshes the docs-owned content from v0.15 to v0.16 so the authored Rust, TypeScript, React, MASM, and tool examples match the v0.16 API and toolchain line.
This PR prepares the current docs tree for the release. It does not create
versioned_docs/version-0.16, updateversions.json, or cut the stable snapshot; those remain part of a separate release PR.static/llms.txtandstatic/skill.mdintentionally carry the post-release 0.16 stable / 0.17 unstable labels. Merge must therefore be coordinated with the v0.16 snapshot cut to avoid publishing those labels early.Out of scope
Changes
llms.txtandskill.mdfor the repository split and v0.16 release context.v0.17.0documentation source.Verification
Checked on 2026-09-11 against head
bf05555daa66eb245376c1a143db9a50ef97187b:git diff --cached --checkpassed before committing the 44 staged files.npm run buildsucceeds locally. No broken anchors originate from/next; broken-link warnings remain, including links into imported Guardian and node pages. This build does not establish that all deploy-time imports at the final release refs are valid.node --check scripts/ingest-guardian.mjspasses.npm run typecheckfails with diagnostics in files outside the latest commit, including unresolved@theme/*imports.mainat4c9f358, with development refs and Guardianv0.15.0. It does not validate this PR head or Guardianv0.17.0.Release gates
v0.16.0tags exist for node, rust-sdk, and web-sdk.4c9f358.mainstill have the v0.15 manifest. Select the v0.16-compatible refs for every imported source, explicitly includebridge-portal(currently absent), and pin the tutorials source to the intended revision. Guardianv0.17.0exists and is selected by this PR's deploy workflow, but the snapshot manifest still pinsv0.15.0.versioned_docs/version-0.16, updatingversions.json, and setting manifestversion: "0.16"/next_version: "0.17". Keep the agent-entrypoint labels synchronized with the published snapshot.Snapshot workflow note:
cut-versions.ymlreads tenINPUT_*variables, but only mapsINPUT_BRIDGE_PORTAL_REFinto the parsing step. Wire the remaining nine manual inputs, includingversion_label, before relying on workflow-dispatch overrides; otherwise define every version/ref directly in the release manifest. The current PR branch is one commit behindmain(the merged migration guide), so a snapshot cut from this head alone would omit that merge.Test plan
v0.17.0, then verify the release deployment. PR checks currently cover CodeQL;deploy-docs.ymlruns onmainpushes or dispatch and publishes to GitHub Pages./next/renders this PR's v0.16 docs before the cut; the current live deployment is frommain, not this PR head./serves v0.16 and/next/advances to v0.17 unstable, consistent withllms.txtandskill.md.