W3C home > Mailing lists > Public > www-style@w3.org > August 2013

Re: [css3-text] editorial nits: index needs tidying

From: Tab Atkins Jr. <jackalmage@gmail.com>
Date: Thu, 15 Aug 2013 10:41:18 -0700
Message-ID: <CAAWBYDAvZp-z+zX+OqurmVCzz=49JFPpn2FK=JRR9G0aSdEJ1A@mail.gmail.com>
To: John Daggett <jdaggett@mozilla.com>
Cc: www-style list <www-style@w3.org>
On Thu, Aug 15, 2013 at 7:16 AM, John Daggett <jdaggett@mozilla.com> wrote:
> An index was recently added to CSS3 Text but the entries need to be
> cleaned up to make the formatting of values consistent, remove
> undefined backlinks ("??"), and assure that all important terms
> are in the index, since there's *lots* of terminology used.

The Index is auto-generated by Bert's processor.  The ?? links are for
unnumbered sections.  Every definition that isn't a property shows up
in the index automatically.  The formatting of terms is automatically
generated from the title/text of each definition.

> Also, I think the structure should be similar to other specs, with
> Changes/References/Index/Property Index in sections separate from the
> appendices.  This makes it easier for implementators to find important
> normative information in places like Appendix F.

I do agree that the auto-genned sections are typically not appendixes,
and don't need to be referenced like another section, and thus don't
need a number/letter.

(fantasai, if you want me to convert Text over to Bikeshed, let me
know.  I'm already working on converting Grid this morning, so I'll be
in the right mode. ^_^)

Received on Thursday, 15 August 2013 17:42:05 UTC

This archive was generated by hypermail 2.4.0 : Friday, 25 March 2022 10:08:33 UTC