bytecodealliance / bytecodealliance/component-docs

Tracking: WASI P3 documentation updates

Ouverte
#341 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
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

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.