W3C home > Mailing lists > Public > public-css-archive@w3.org > June 2020

Re: [csswg-drafts] Convert CSS2 to Bikeshed (#5196)

From: Tab Atkins Jr. via GitHub <sysbot+gh@w3.org>
Date: Sat, 13 Jun 2020 00:41:36 +0000
To: public-css-archive@w3.org
Message-ID: <issue_comment.created-643535527-1592008895-sysbot+gh@w3.org>
My intent is indeed that multipage output will be supported from a single source file; having each "page" be a separate file that you include in is possible (and probable!), but won't be necessary. So don't take that as a concern here.

----

That said, I do agree that keeping the chapters as separate files which are included together into the final document probably makes for an easier editting experience most of the time (unless you're doing find-and-replace across the whole thing, but even then, a good editor can do that across multiple files in a folder).  And yeah, those very large specs *should* be split; I've thought about doing precisely that for Flexbox, Grid, Color, and Selectors, because they're very difficult to navigate currently.

On the other hand, I'm not the one doing this work, so if it would be a pain to reverse the combining, whatever. ^_^  However, I would at minimum ask for some big-text section separators (<https://tabatkins.github.io/bikeshed/#big-text>) so it can be reasonably navigated by editors with minimaps.

-- 
GitHub Notification of comment by tabatkins
Please view or discuss this issue at https://github.com/w3c/csswg-drafts/pull/5196#issuecomment-643535527 using your GitHub account
Received on Saturday, 13 June 2020 00:41:38 UTC

This archive was generated by hypermail 2.4.0 : Tuesday, 19 October 2021 01:31:27 UTC