alphagov/manuals-frontend — pull request #124 by alicebartlett (2014-12-16 14:01:33+00:00)
Title: Fix html structure

https://github.com/alphagov/manuals-frontend/issues/104

The problem: Every page of a manual has the same `

`. This is not very informative. In many cases the most useful heading on the page is actually the `

`.

The solution:
- Keep the `

` in the heading, add an `aria_labelledby` to the `` tag to point to it's child `

`.
- Promote the content title from an `

` to an `

`
- Add an `

` around the main content of the document and add an `arial_labelledby` to the newly promoted `

`
- Move the `id=content` to the meat of the page (stuff below the `

... `

Outstanding questions:
For the index page, the manual title (the one in the header) actually is the most important and useful `

`. In this case I've marked up as the following, but am unsure if it's right (and can't find anything online). I guess what I'm wondering is, is it appropriate to have two bits labelled by the same element, and, furthermore, is it OK if that label is a descendant of one of the elements and not of the others (technically it looks like a "niece" of the other element but I'm p. sure nobody has ever called that relationship in HTML that...)

```

...

...

...

```