Skip to content

Commit 3b8069d

Browse files
committed
[indexes] Add intro.
1 parent cb0433a commit 3b8069d

1 file changed

Lines changed: 24 additions & 0 deletions

File tree

indexes/Overview.bs

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,30 @@ ED: https://drafts.csswg.org/indexes/
1010
Abstract: A listing of every term defined by CSS specs.
1111
</pre>
1212

13+
Introduction {#intro}
14+
=====================
15+
16+
This is a non-normative document.
17+
It lists every term defined in CSS,
18+
as long as it's marked up correctly for the spec generator.
19+
It is intended as a reference document for authors, implementors, and spec authors,
20+
to aid in finding the definition for a term
21+
hidden somewhere in the haystack of CSS specs.
22+
23+
There are some things missing,
24+
and there are several mistakes,
25+
either from use of legacy markup patterns that haven't been udpated yet,
26+
or the dfn-type-autodetector misfiring.
27+
These will be cleaned up over time.
28+
29+
Issue: A notable absence at the moment is a list of all the "dfn" type definitions--
30+
the ordinary words and phrases given meaning in CSS.
31+
This will show up shortly,
32+
as soon as I add a mechanism to limit the index generation
33+
to specs from a particular group.
34+
(Right now you have to either list every spec you want explicitly,
35+
or draw from all specs.)
36+
1337
Properties and Descriptors {#properties}
1438
========================
1539

0 commit comments

Comments
 (0)