[Meta] Spec Multiverse

[codehag]

The specification has multiple different audiences: Developers using the language, Implementors, and Language designers are three rough categories. They need different things from the spec, and they have different questions.

Similar projects: WHATWGs HTML generator

Could we somehow write and generate the spec for these three different audiences? What would be the requirements of doing that successfully? How different are our populations?

[jmdyck]

For comparison, WHATWG generates a few versions of the HTML spec. The 'full' version comes in single-page and multi-page (and PDF). The "developer's edition" excludes stuff that web devs don't need to know. And there appear to be a couple "behind the scenes" versions that maybe relate to taking a snapshot for the W3C to review + post.

They maintain a single source file, with markup to include/exclude chunks of it for different versions.