Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[Meta] Spec Multiverse #30

Open
codehag opened this issue Sep 26, 2024 · 1 comment
Open

[Meta] Spec Multiverse #30

codehag opened this issue Sep 26, 2024 · 1 comment
Labels
Available documentation Improvements or additions to documentation Tools for Standardization Tools for improving the process of creating, and the understanding of Standards

Comments

@codehag
Copy link
Collaborator

codehag commented Sep 26, 2024 •
edited
Loading

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?
@codehag codehag added documentation Improvements or additions to documentation Tools for Standardization Tools for improving the process of creating, and the understanding of Standards Available labels Sep 26, 2024
@codehag codehag changed the title [Meta] Exploring Multi-view on the Specification [Meta] Spec Multiverse Sep 26, 2024
@jmdyck
Copy link
Collaborator

jmdyck commented Sep 26, 2024

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
Available documentation Improvements or additions to documentation Tools for Standardization Tools for improving the process of creating, and the understanding of Standards
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@jmdyck @codehag