- From: Austin William Wright <aaa@bzfx.net>
- Date: Mon, 21 Jul 2014 07:08:38 -0700
- To: public-webplatform@w3.org
- Message-ID: <CANkuk-WHczX-sCeM_Juny2W3yT9XT3gzq_see_PiowERxKgEeg@mail.gmail.com>
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