You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
After some discussion at the SIG Docs meeting, I expressed the beginnings of a plan to move to a format for the docs that is WIT-first.
The basic format for guides might start to look like the following:
Introduce a WIT interface
Satisfy dependencies with tooling (if any)
Build language implementation/bindings that satisfy the interface
While (3) is language specific, (1) and (2) are actually not, so it might make sense to reorganize the guide itself so that the first two steps are unified, and the third is broken out by language.
This is a bit hard to grasp conceptually, so the second step to being able to discuss it in this issue is creating a prototype that shows how navigation would change, etc.
Activity
vados-cosmonic commentedon Jan 28, 2026
This is probably not as necessary anymore with the refactoring of the tutorial/initial guide that has already landed.
If we add any new sections this might be worth doing but for now let's close this and re-open if necessary.