Roadmap

Where Wit is and what comes next. Pre-1.0, breaking changes are allowed under 0.x with notes and, where possible, a wit migrate rewrite.

Status now

0.3 is the syntax redesign: one parameter form, definition headers, ::body::, closeless uses, the parenthesis form, value-block uses, loop positions and entry lists, with the 0.2 forms removed and wit migrate to carry files across — plus bundled templates, warnings, and numbering, cross-references, footnotes and citations. Two renderers (HTML, Markdown), PDF through Chrome, the CLI and a VS Code extension ship. See the changelog.

Release 0.3.0 — published packages.
Page-aware PDF — page footnotes and page numbers in the contents, through an optional paginator.

The 1.0 bar

A docs site (this one — itself a dogfood test), published packages, and a versioned, executable spec the spec.

VS Code extension

Highlighting, diagnostics (including referenced files), hover, go-to-definition, references, outline and completion ship. Planned:

Quick wins. Live HTML preview, snippets for the preferred forms, code folding, a file icon, palette commands.
Medium. Clickable document links, rename, workspace symbol search, signature help from definition headers, quick fixes that run wit migrate.
Bigger. Format-on-save, script highlighting inside <% %>, marketplace publishing.

Later

A component definition with scoped CSS, parameter defaults, a --watch build, incremental reparse hooks and a separate theme package. Out of scope: interpolation in ordinary prose (data reaches prose as @name.field) and a contains condition.