W3C home > Mailing lists > Public > public-webplatform@w3.org > October 2012

Re: Feature centric documentation

From: Asbjørn Enge <asbjorn@hanafjedle.net>
Date: Wed, 17 Oct 2012 08:51:41 +0200
To: Chris Mills <cmills@opera.com>
Cc: eternicode@gmail.com, public-webplatform@w3.org
Message-ID: <1E128BC438484772A493A79D11A936F2@hanafjedle.net>
Excellent :-) I started the article here:  

http://docs.webplatform.org/wiki/featuremap

I didn't get very far yet, so feel free to jump in and expand the map!!  

mvh,
--  
Asbjørn Enge

m - 47011554
e - asbjorn@hanafjedle.net
t - @asbjornenge


On Tuesday, October 16, 2012 at 11:41 AM, Chris Mills wrote:

> That sounds ok to me. We can always move or remove it, if it really isn't working ;-)
>  
> We already have a topic map at http://docs.webplatform.org/wiki/WPD:Content/Topic_Hierarchy, which may help, even though that is theoretical complete feature map, rather than a reflection of what is actually there.
>  
> Best,
>  
> Chris
>  
>  
> On 16 Oct 2012, at 07:36, Asbjørn Enge <asbjorn@hanafjedle.net (mailto:asbjorn@hanafjedle.net)> wrote:
>  
> > I like the sounds of a featuremap :-) It can start out as an experiment to see how (or if) we can divide the docs into such a map. If it ends up useful then we can perhaps link to it from the landing page as you suggest.
> >  
> > Where in the current structure would we put such a page? http://docs.webplatform.org/wiki/featuremap ?? Would anyone mind terribly if we try build such a page as an experiment in that location?
> >  
> > @asbjornenge
> >  
> > On Monday, October 15, 2012 at 4:16 PM, Andrew Rowls wrote:
> >  
> > > Disclaimer: I am, myself, a newbie when it comes to wikis. I rarely browse them (wikipedia when I have a specific topic, usually through google searches, and other community wikis [think Halopedia, etc] on occasion, again through google searches), and even more rarely edit them.
> > >  
> > > As a newbie, though, I'm thinking my "experience" with them is particularly relevant. No to sound arrogant or anything (y'all will keep me humble, right?).
> > >  
> > > > * Searching is only good if you know what you are looking for.
> > > > * Digging needs a relevant structure to work.
> > > >  
> > >  
> > >  
> > > +1 on both of these.
> > >  
> > > My experience with mediawiki's search is that it's difficult to use/understand at best, and completely useless at worst. There's a relevant question in the forum[1] which says:
> > >  
> > > > Say for example I want information on the table HTML element, so I do
> > > > a search for "table":
> > > > http://docs.webplatform.org/w/index.php?search=table&fulltext=+&title=Special%3ASearch
> > > >  
> > > > The first 8 of 14 title results on that page are [duplicates], and
> > > > the page html/elements/table doesn't appear in the title results list
> > > > at all.
> > > >  
> > >  
> > >  
> > > I don't know if this is inherent to medawiki's search, or if it's just a case of bad tuning. Either way, as it stands it has very limited usefulness.
> > >  
> > > As for digging, I've always thought wikis were very low-discoverability -- that is, it's difficult, if not impossible, to simply explore (randomly, without a specific topic) a wiki's content. Relevant intra-article links are explicit and manual (for the most part -- I understand there's some automatic linkage where CamelCase words are concerned?), so a) existing links may not be relevant, and b) relevant links may not yet have been made. I read somewhere that someone had mentioned using a sitemap plugin (which I'm probably +1 for), but again, that's something that has to be explicitly setup, so your average wiki probably doesn't have it. Essentially, you have to know what you're looking for to make good use of a wiki.
> > >  
> > > > I'm not sure, but to me a "feature" type approach seems natural.
> > >  
> > > I think a featuremap is a great idea, though I'm not sure it should go on the front page. Perhaps briefly summarized (or sampled) and linked to from there. The front page, as it stands, is a "general overview" of the wiki, its purpose, how to contribute, and a starting point for finding some potentially relevant content (the "Explore our web dev docs" section), and I think that's probably a good "first impression".
> > >  
> > > So +1 for a featuremap page, but with its presence on the homepage being similar to the "Explore" table, with maybe the 6-8 most popular / widely used/discussed* topics listed and a link to the featuremap page from there.
> > >  
> > >  
> > > Andrew / eternicode
> > >  
> > >  
> > > [1] http://talk.webplatform.org/forums/index.php/2063/can-search-accuracy-be-improved
> > >  
> > > * There's a topic for discussion! Criteria for "popular".  
Received on Wednesday, 17 October 2012 06:52:10 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:57:34 UTC