Skip to content

Add WASI versioning infrastructure and convert wasmtime page#340

Open
ericgregory wants to merge 1 commit intobytecodealliance:mainfrom
ericgregory:wasi-p3-versioning-infra
Open

Add WASI versioning infrastructure and convert wasmtime page#340
ericgregory wants to merge 1 commit intobytecodealliance:mainfrom
ericgregory:wasi-p3-versioning-infra

Conversation

@ericgregory
Copy link
Copy Markdown

The WASI P3 release is approaching, and the Component Model Book needs a way to present content that differs
between P2 and P3 without forking pages or duplicating sections. This PR introduces the infrastructure for that (tabbed content blocks and a version notice admonition) and demonstrates the pattern on one real content page (/running-components/wasmtime.html).

Major changes:

  • Add mdbook-tabs preprocessor (v0.2.3 for wire-protocol compatibility with the pinned mdbook 0.4.21) and register theme/tabs.css + theme/tabs.js in book.toml
  • Convert running-components/wasmtime.md to use tabs for the two version-sensitive sections (intro and HTTP
    serving), leaving the wasmtime run and custom-exports sections untabbed since they behave identically across versions

Introduces tabbed content support for WASI P2/P3 via the mdbook-tabs
preprocessor, a version-notice component, and demonstrates the pattern
on the Wasmtime running-components page.

- Add mdbook-tabs preprocessor and installed tabs.css/tabs.js assets
- Customize tab label colors to use --sidebar-active per theme, with
  a Rust-theme override where the orange accent loses contrast on tan
- Add theme/version-notice.css for a branded, theme-aware notice bar
- Register the new CSS/JS in book.toml
- Convert running-components/wasmtime.md to tabbed P2/P3 content,
  hedging wasmtime serve claims against current release notes
- Update links to the WebAssembly/WASI monorepo (wasi-cli and
  wasi-http were archived 2025-11-25)
- Correct the wasmtime serve availability claim from v14.0.3 to v18.0.0
  to match the Wasmtime CLI documentation
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.

1 participant