W3C home > Mailing lists > Public > public-webplatform@w3.org > July 2014

Extraneous pages and normative references

From: Austin William Wright <aaa@bzfx.net>
Date: Mon, 21 Jul 2014 07:08:38 -0700
Message-ID: <CANkuk-WHczX-sCeM_Juny2W3yT9XT3gzq_see_PiowERxKgEeg@mail.gmail.com>
To: public-webplatform@w3.org
While trying to add summaries to pages, I'm noticing a number of pages that
are obsolete or don't belong. For example, <
http://docs.webplatform.org/wiki/dom/HTMLElement/item> isn't any method
that I know of (maybe confused for <
http://docs.webplatform.org/wiki/dom/HTMLCollection/item>?).

If it's defined somewhere (but currently unimplemented by my user agent),
then I would expect a reference. If not, then the page needs to be deleted.
(Considering there's no UA support listed, and it's not supported by my UA,
and it's not listed in the HTMLElement definition, I'd delete the page if I
could.)

So to solve this problem, can we add a field to define a normative
reference for pages? Ideally, I'd like to be one click away from the
normative WebIDL. Then pages with "citation needed" could eventually be
deleted.

Additionally, I don't see much use in listing ALL the pages underneath e.g.
DOM, CSS, or HTML, and it does so in a three-column table which looks
strange, and doesn't even fit on my narrow laptop screen. The pages might
be better served by just linking to the appropriate Special:PrefixIndex or
Category page, and listing a select few relevant pages with a Semantic
Mediawiki query. For instance, I edited <
http://docs.webplatform.org/wiki/dom> with the following:

    See the [[:Category:DOM|DOM category]] for a list of all classes,
methods, and properties underneath this page, and
[[Special:PrefixIndex/dom/]]

And added the following Semantic Mediawiki query:

{{#ask:[[Category:DOM]][[Category:API_Objects]]
|format=category
|limit=500
|searchlabel=… further results
}}

However, this query would work better if there were a "WebIDL Interface
Name" property for pages, the same way there is a Summary property.

CSS would probably list CSS properties; HTML, tags.

So, the suggestions for Semantic Mediawiki properties:
* Normative reference/describing specification
* Has WebIDL Interface Name; CSS property name; etc

Thanks,

Austin Wright.
<http://docs.webplatform.org/wiki/User:Awwright>
Received on Monday, 21 July 2014 14:09:06 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:21:02 UTC