Documentation mop-up

[dracos]

• [x] update how-it-works page text (include diagram of some sort) to be superuseful (links with https://github.com/mysociety/fixmystreet/issues/599#issuecomment-35637207 )
• [ ] http://fixmystreet.org/overview/ is currently copy of old front page, needs changing to match new info layout
• [x] fix incomplete description of SEND_REPORTS_ON_STAGING behaviour (qualify with version number etc)
• [ ] make each section header (in nav) link to general section pages (these are useful to link to) which just link to the pages within them - if they can be made to look like they're links
• [x] move manual install process into its own page (manual_install)
• [x] add running/surveys page (links with #728)
• [x] check that fms_and_mapit page and boundaries page don't overlap too much (reconcile duplicate text, move boundary-only stuff into boundaries)
• [ ] now we have per-config examples, link mentions of config vars throughout to their entry in the config page
• [x] get A Designer to make the class="glossary" links look different from full-on links
• [ ] tidy some TODOs that are tucked in the customising/config page
• [ ] run through the customising/* pages and check wording (Dave has some changes in some places)
• [ ] check for obvious missing glossary links where terms already exist
• [ ] consolidate to hyphens in filenames (underscore/hyphen mix, harumph) (may not be important)

[wrightmartin]

get A Designer to make the class="glossary" links look different from full-on links

It looks like class="glossary" is used on the <dl> too - is that intentional? It appears they are sharing styles. (line 54 of https://raw.githubusercontent.com/mysociety/fixmystreet/gh-pages/glossary.md)

[davewhiteland]

martin yeah -- so dl.glossary is the glossary (or a thing styled like the glossary -- I used it on the config pages too for a title->content relationship), and a.glossary is a link into the glossary.

If this is naughty (maybe a.glossary is supposed to be a.glossary-link in the Right Way) obviously it can be changed.

Note I've done the same in Alavateli docs.

[wrightmartin]

@davewhiteland probably easier to rename dl.glossary to .glossary_list or something similar