bytecodealliance / bytecodealliance/component-docs
Tracking: WASI P3 documentation updates
- Langage dominant
- Rust
- Étoiles
- 137
- Forks
- 88
- Merge moyen
- 5 j 12 h
- PR mergées (30 j)
- 4
Description
The Component Model book needs to be updated for P3. This issue tracks the overall effort; individual child issues will be filed for each reviewable unit of work below.
The high-level approach is inline tabbed content for sections that differ between P2 and P3. Pages that are version-agnostic stay untouched. A small admonition at the top of each version-variable page signals that tabbed content is present.
Infrastructure landed in #340:
- `mdbook-tabs` preprocessor registered with theme-aware `tabs.css`
- `version-notice.css` for the page-level callout
- `/running-components/wasmtime.html` converted as the first real demonstration
Remaining work (child issues proposed for filing after discussion):
- [ ] Document WASI P3 async primitives (`async func`, `stream`, `future`) in the Understanding section
- [ ] Update WIT reference and WIT by Example for WASI P3 syntax
- [ ] Convert Rust "Building a simple component" guide for WASI P3
- [ ] Convert JavaScript "Building a simple component" guide for WASI P3
- [ ] Convert jco "Running components" page for WASI P3
- [ ] Add a WASI P2 to P3 migration guide
- [ ] Update the Canonical ABI page with async extensions
- [ ] Update the FAQ with WASI P3 questions
- [ ] Cross-link with WASI.dev for WASI P3 content
Related: #340
Guide de contribution
Ouvrir le guide de contribution
Piste de recherche
Start by reading #340 and the listed P3 work areas: Understanding, WIT reference, WIT by Example, the Rust and JavaScript guides, the jco running-components page, Canonical ABI, FAQ, and migration content. Confirm which child issue is available before choosing a unit; done means a reviewable P3 documentation update with the appropriate versioned tabs, notice, and cross-links.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- javascript, rust, wasm
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Activité
- Calme
- Clarté
- À clarifier
- Accessibilité débutants
- 25/100