19182 2012-10-01 22:27:54 +0000 Improve the info architecture for the major landing pages 2012-10-07 02:40:23 +0000 1 1 1 Unclassified webplatform.org info architecture unspecified Macintosh MacOS X RESOLVED NEEDSINFO P2 major --- 1 k7glim schepers julee public-webplatform-bugs oldest_to_newest 74979 0 k7glim 2012-10-01 22:27:54 +0000 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. 75499 1 julee 2012-10-07 02:29:52 +0000 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.