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

Re: Generated related pages too generic

From: Jonathan Garbee <jonathan.garbee@gmail.com>
Date: Mon, 21 Apr 2014 11:32:16 -0400
Message-ID: <CANQy2y23b9BV8Gw=-fYv7_Nwgfm2=Fr4Z4_FpbJK-ZLViqryOw@mail.gmail.com>
To: "public-webplatform@w3.org" <public-webplatform@w3.org>
We can already manually specify additional stuff. On that note though, we
should float manually related links up to the top of the section. Putting
the generated list under. Currently the generated list appears first, then
any manual links.

On the note of improving, one idea (at least for HTML attributes) is the
"Applies to" stuff. Is there some way we could take that (and find a
comparable section in other areas) and say anything else that can apply to
this element, should be related? That way at least what is shown is more
targeted to things that would apply in conjunction with that attribute. I'm
not sure about other areas of the docs though off the top of my head. This
just hit me looking over the template.


On Mon, Apr 21, 2014 at 11:21 AM, Eliot Graff <Eliot.Graff@microsoft.com>wrote:

>  Yes, please, let’s fix this.
>
>
>
> I can’t remember what the reasoning was, but this was done on purpose when
> we first set up the templates. I agree that they are overcrowded, but let’s
> not throw out the baby with the bathwater. Perhaps we can determine a small
> and useful set of core topics for each area AND have authors/editors
> determine additional links to specify as well?
>
>
>
> My 2 cents.
>
> Eliot
>
>
>
> *From:* Jonathan Garbee [mailto:jonathan.garbee@gmail.com]
> *Sent:* Monday, April 21, 2014 8:04 AM
> *To:* public-webplatform@w3.org
> *Subject:* Re: Generated related pages too generic
>
>
>
> How do we make what is automatically generated more accurate though?
> Without either building/finding an engine that can understand and correlate
> the content or adding more stuff into the template to help editors put
> meta-data in that makes it more granular.
>
>
>
> On Mon, Apr 21, 2014 at 10:33 AM, Eliezer Bernart <
> eliezer.bernart@gmail.com> wrote:
>
>  Hey Folks!
>
>
> This is happening because the See Also Section [1] template lists all the
> pages that are categorized as "HTML" pages [2].
>
> I agree with Garbee, we can't choose which links will be displayed when
> the template auto generate the list, so we can have a lot of unrelated
> things.The same is happening in other pages that also have this section,
> CSS pages for instance [3].
>
> I also agree that manual related links will be way more effective and
> accurate.
>
> But it's good to keep in mind that removing the automatic listing will
> affect all the pages that are using this section.
>
> Maybe instead of removing the section we could make the topics more
> accurate, and doing this we also could have better suggestions.
>
> Hope that helps.
>
>
> [1] http://docs.webplatform.org/wiki/Template:See_Also_Section
> [2]
> http://docs.webplatform.org/w/index.php?title=Special:SearchByProperty&offset=0&limit=500&property=Topic+Cluster&value=HTML
> [3] http://docs.webplatform.org/wiki/css/properties/vertical-align
>
>
>
>
> Eliezer
>
>
>
> @eliezerbernart
>
> eliezerb
>
>
>
> On Mon, Apr 21, 2014 at 10:46 AM, Jonathan Garbee <
> jonathan.garbee@gmail.com> wrote:
>
>  The related pages links that are generated by selecting the checkboxes
> under "Topic Clusters" of the "See Also" section when editing are too
> general/broad. For example, on the disabled attribute [1] page I am seeing,
>
> * BGCOLOR
>
> * HTMLAudioElement
>
> * Pointer Events Primer
>
> * List
>
> * height
>
> * !doctype
>
> * dl
>
> * head
>
>
>
> etc. A bunch of almost completely unrelated things. Is there a reason that
> these are generated?
>
>
>
> I think it would be best to remove this generation of links in favor of
> simply having editors manually cross-link related things. That way we get
> higher-quality links that are known to be related in some way to the
> content at hand.
>
>
>
> Thanks,
>
> -Garbee
>
>
>
> [1] http://docs.webplatform.org/wiki/html/attributes/disabled
>
>
>
>
>
Received on Monday, 21 April 2014 15:32:51 UTC

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