nightscout / nightscout.github.io

website, meta repo for whole project
GNU General Public License v2.0
107 stars 233 forks source link

Suggestions for cleaning up all the online documentation #22

Closed jenm999 closed 3 years ago

jenm999 commented 10 years ago

The “front page” of this project, and where all inquiring minds should be directed: http://nightscout.github.io/ . Once these changes are made, I suggest putting this at the very top of the Facebook group because the veterans are having to direct newbies all the time.

The above “front page” has too many links on it and they are not organized. From what I can discern there should be 3 major sections:

  1. Quickstart Guide (rename Quickstart, keep subsections)
  2. Wiki (make this a section)
  3. Github (the code)

Suggested specific edits:

  1. Delete Guides header, Quickstart button and Wiki button
  2. Rename Groups to Links
  3. Move hackingtype1.com link from the Github menu to Links
  4. Move trello link from Github menu to Links and label it like you did the Facebook link with what the heck trello is (seems to be some kind of development hangout?)
  5. Why is there a link to “this website” under Github
  6. Delete docs – these are all pages on the wiki; it’s just confusing
  7. Create page on the wiki for Azure free account management and copy over the info from the posts section
  8. Create page on the wiki for Subdued color scheme and copy over the info from the posts section
  9. Delete posts section
  10. Delete Azure and Subdued posts from the quickstart guide

Copy this document after the three major sections identified above https://attachment.fbsbx.com/file_download.php?id=300539976776929&eid=ASvW380xAmqDoxvM64ityWfa-R8zYLe42AHM5Og7Gj2NKlPUM6JweOx2qA7l7btATAY&inline=1&ext=1403142771&hash=ASu5AewhgLakw7ZN Then delete it from Facebook

Delete this as it’s now been integrated into the Quickstart Guide https://www.facebook.com/groups/cgminthecloud/566399763481284/

Create a page in the wiki called Dexcom Error Codes and then copy this post to that page: https://www.facebook.com/notes/cgm-in-the-cloud/dexcom-error-codes/561005774020683 Then delete it from Facebook

Reconcile this document: https://attachment.fbsbx.com/file_download.php?id=308379319313798&eid=AStWpp_ptNyRFj_KrOuo0sYSVSeFDIPrsQIfjJpV2brwAsNrQDVQKgod73zm3u-ULZI&inline=1&ext=1403142981&hash=ASupexQRvVU9ZMby With the What Uploaders work best? Link on the wiki. Then delete it from Facebook

That’s all for now, but I’ll have more suggestions on cleaning up the wiki another day.

Oh, and let’s add a snazzy image to the front page. Maybe this one? https://fbcdn-sphotos-d-a.akamaihd.net/hphotos-ak-xpf1/t1.0-9/10408646_786591064708847_4157694538599979556_n.jpg

THANKS!

Jen Montbach

--- Want to back this issue? **[Post a bounty on it!](https://www.bountysource.com/issues/2723503-suggestions-for-cleaning-up-all-the-online-documentation?utm_campaign=plugin&utm_content=tracker%2F2443593&utm_medium=issues&utm_source=github)** We accept bounties via [Bountysource](https://www.bountysource.com/?utm_campaign=plugin&utm_content=tracker%2F2443593&utm_medium=issues&utm_source=github).
bewest commented 10 years ago

Some more from Jen:

Two more suggestions: supported devices (we've just discovered does not come up on my DH's blackberry) and supported browsers (I can't get the graphs to render right in Firefox but it works like a dream in Chrome)

Oh, and one more thing - in the Quick start guide, make the Forking link open a new tab so you can keep the directions open.

psonnera commented 3 years ago

Obsolete.