This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 19182 - Improve the info architecture for the major landing pages
Summary: Improve the info architecture for the major landing pages
Status: RESOLVED NEEDSINFO
Alias: None
Product: webplatform.org
Classification: Unclassified
Component: info architecture (show other bugs)
Version: unspecified
Hardware: Macintosh MacOS X
: P2 major
Target Milestone: ---
Assignee: Doug Schepers
QA Contact: public-webplatform-bugs list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-10-01 22:27 UTC by k7glim
Modified: 2012-10-07 02:40 UTC (History)
1 user (show)

See Also:


Attachments

Description k7glim 2012-10-01 22:27:54 UTC
A proposal for different info architecture for the main landing pages.

Issue 1: The main page (http://docs.webplatform.org/wiki/Main_Page) currently has double links for the same technologies; for example, there's a tutorial landing page and a reference landing page for HTML and CSS (JavaScript is inconsistent in that there is just a link to the reference, and no tutorial). 

Proposal: 
Collapse the two links to just one. This cleans up the page and presents fewer options that the user needs to skim through. 

Issue 2: For the technology main pages, such as CSS (http://docs.webplatform.org/wiki/CSS), create just one landing page, instead of two. 

Proposal: The way MDN does it is elegant: https://developer.mozilla.org/en-US/docs/CSS. There's a main landing page (everything CSS!) with forks to landing pages: references, tutorials and demo. As a writer and user of this page, I prefer this solution. 

MDN's info architecture enables people to send out the main CSS URL to cover all things CSS. But WPD's main CSS page (http://docs.webplatform.org/wiki/CSS) is just the reference part of CSS.
 
Issue 3: The reference page adds an additional layer of links that you have to click through.

Proposal: Why add another layer of index (http://docs.webplatform.org/wiki/CSS -> http://docs.webplatform.org/wiki/CSS/Properties), when you can list the index in the main CSS Reference page (https://developer.mozilla.org/en-US/docs/CSS/CSS_Reference)?

The nice thing with WPD is that properties and selectors are categorized.
Comment 1 JuleeAtAdobe 2012-10-07 02:29:52 UTC
Re: Issue 1: On main page http://docs.webplatform.org/wiki/Meta:Main_Page, I collapsed tutorials and reference into the HTML/CSS/JavaScript links. To make navigation really clear, I remove extra wording and made the 6 major categories prominent on the page: Concepts | HTML | CSS | Accessibility | JavaScript | SVG.

Re: Issue 2: On the main javascript page: Created 3 main cells for Concepts | Tutorials | Reference.

Re: Issue 3: Interesting that the index is the first matter on the page, and concepts is the last. I need to confirm that there will be an easily discoverable getting started experience for the visitor before I tackle this one.