W3C home > Mailing lists > Public > public-html@w3.org > June 2015

Proposed split of the HTML specification

From: Robin Berjon <robin@w3.org>
Date: Thu, 11 Jun 2015 11:16:52 +0200
Message-ID: <55795204.1090906@w3.org>
To: "HTML WG (public-html@w3.org)" <public-html@w3.org>
Hi all,

as part of the many discussion about the next steps in HTML, the 
question of splitting up the HTML spec has come up again. In order to 
make the discussion simpler, I have made:

     1) A tool that makes it easy to generate splits.

     2) A proposed split to get the discussion rolling.

The idea isn't that my proposed split is perfect; the idea is however 
that people who want to propose alternatives ought to do so by actually 
producing one rather than arguing about it. Smaller tweaks to an 
existing split should be made as pull requests against it.

The DIY breakup is up at:

     https://github.com/darobin/breakup

I encourage you to actually read the README.

The proposed split is up at:

     http://darobin.github.io/breakup/specs/

Some things worth noting about it:

   • I like smaller specs, it's a lot of pieces.

   • The generated output is not perfect, there are notably problems 
with WebIDL and references. The goal here is to give a concrete idea, 
not to produce perfect documents.

   • The chunking at times cobbles together section that weren't 
adjacent in the monolith, which can cause strange transitions. Overall 
there are wording nits, these can be ironed out *after* (and if) a split 
has happened.

   • Some content is just dropped on the floor. The list of dropped 
sections is in the JSON.

   • Cross-linking *ought* to work, but I haven't extensively tested it, 
bug reports welcome.

Go have fun! :)

-- 
Robin Berjon - http://berjon.com/ - @robinberjon
Received on Thursday, 11 June 2015 09:16:54 UTC

This archive was generated by hypermail 2.3.1 : Thursday, 29 October 2015 10:16:44 UTC