suggest we add table of contents to web documentation

[James Hunt]

We currently have two main (and excellent) pages on snappy:

1) http://www.ubuntu.com/things
2) https://developer.ubuntu.com/en/snappy

However, they are both extremely long documents (one is 19 screenfuls on my monitor, the other 15 screenfuls).

- Document (1) has no table of contents.
- Document (2) does sort of have a table of contents at the top, but only 2 of the links jump to within the document (#tour and #snap-developers) and it is not clear from the presentation that the other links are actually external links.

Please can we consider:

a) Adding well structured Table of Contents (ToC's) to both documents.
b) Adding some sort of visual clue that some links are internal whilst other are external.

Suggestion: Add a hideable/toggleable ToC in the [huge] margins.

[Alexander Sack (asac)]

subscribed peter and dpm to comment/think about this.

[Peter Mahnke (peterm-ubuntu)]

for ubuntu.com we don't have a pattern for tables of contents, I don't really think it fits with the site.

personally I think we should make the page simpler in the following ways:

1. move the partners into a new 'snappy' programme on partners.ubuntu.com
2. display a rotating list of these partner logos on ubuntu.com/things
3. move 'Getting started with a Beaglebone Black' to a new page on developer.ubuntu.com
4. move 'WebDM: The web device manager' to a new page on developer.ubuntu.com

[Daniel Holbach (dholbach)]

I'm taking care of 3 and 4.

I'll open a bug task for developer-ubuntu-com - and we can move the current one to ubuntu-website-content.

[Daniel Holbach (dholbach)]

4 is done: http://developer.ubuntu.com/snappy/guides/webdm
3 is WIP.

[Daniel Holbach (dholbach)]

4: https://developer.ubuntu.com/en/snappy/install/things/