tidepool-org/tidepool-org.github.io — pull request #10 by cmakler (2014-03-07 21:24:06+00:00)
Title: Main developer portal page reorg

I've reviewed the main page of the developer portal and have these as recommended revisions. I didn't write much, but tried to organize text already on the page to emphasize the fact that this is a developer portal.

* I edited the first few paragraphs of the page to emphasize that this is the developer portal, changing the main title from "About the Tidepool Project" to "Tidepool Developer Portal." My assumption is that the reader has come to this site from the Tidepool site already. I brought over the description of this site from the Github repo ("This is a microsite for helping to guide and manage the open source nature of our work.")
* The page had previously had a number of links to the other pages (how to help, technical documentation, etc.) interspersed throughout the narrative, and not necessarily in the order they should be seen by a newbie. (It even said "If this is your first time getting exposed to Tidepool, however, we recommend reading through the following pages first.") I collected all the links to the sub-pages of the site into one list, and put it in the order someone coming to the site for the first time should read them.
* I moved the text about improving documentation to the "how to help" page (there was already some there)
* I moved the text about how to communicate with the team from the "how to help" page to the main page

Please note that all of these are just suggestions based on what I thought would be helpful based on my own experience as someone coming to the site for the first time. Please feel free to accept/reject/revise as you see fit.

CRM