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

Re: Extraneous pages and normative references

From: Amelia Bellamy-Royds <amelia.bellamy.royds@gmail.com>
Date: Mon, 21 Jul 2014 10:26:47 -0600
Message-ID: <CAFDDJ7wCiLmCY39rHnL1bmbijgk_pbtMf7GxDZLqKEyPYjXzkw@mail.gmail.com>
To: Austin William Wright <aaa@bzfx.net>
Cc: List WebPlatform public <public-webplatform@w3.org>
Great feedback Austin,

About the page for a non-existent method:

There are two possibilities in this situation.  One is simply that it was
misplaced when imported from MSDN.  The other is that the page is for a
non-standard Internet Explorer method.  In this case I think it's the
former, and since dom/HTMLCollection/item already exists, the duplicate
page can probably be marked for deletion (for now, that just means adding
an editorial note; although I'm starting to think there is a justification
to bring back the mark for deletion flag).

About page listings:

This is a known issue, the default table formatting is very bad.  It only
gets worse when there are numerous very long listings in a page.

I liked your solution, and have cleaned it up a bit:
http://docs.webplatform.org/wiki/dom

I've used the "Page Title" value, which is nearly always the interface
name.  I've also narrowed the query to only list pages that have a
wiki/dom/ file path.  Unfortunately, the "Category" output format doesn't
work properly when you sort by something other than the full page name, so
the alphabetical headers are also gone.

For those who want to compare, Austin's version is here:
http://docs.webplatform.org/w/index.php?title=dom&oldid=64112

The previous version, with the poorly formatted table, is here:
http://docs.webplatform.org/w/index.php?title=dom&oldid=44914

We should aim for a consistent look in all the top-level pages, so if
people like the stripped-down listings, then I second Austin's suggestion
that similar clean-ups should be applied to the top-level CSS, HTML and SVG
pages.

P.S.  I created a new template to get the listings to display the page
title as the link text instead of the full file path.  It will probably be
of use in cleaning up other areas where we've got verbose default page
listing tables.
http://docs.webplatform.org/wiki/Template:Summary_List_Entry

AmeliaBR



On 21 July 2014 08:08, Austin William Wright <aaa@bzfx.net> wrote:

> 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 16:27:18 UTC

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