Improve the documentation

Registered by Rob Cresswell on 2017-06-08

The docs have been fairly neglected for a while. A lot of the information is outdated and/or disorganised. We should do a pass over the information, removing or updating old parts, as well as filling gaps where we find them. We should also update the docs to match the visual style of the docs team.

The documentation structure will be based off the spec at https://review.openstack.org/#/c/472275/

- install/ --This will cover installation, deployment and configuration of Horizon and its plugins. If a
  consumer of Horizon is only interested in utilising it as part of their cloud, this section should provide
  all the information they need.
- contributor/ -- Anything having to do with contributing to the project. This will include developer
  setups, tutorial guides, and conceptual information. "Contributor" is important here, as it covers not
  just direct code contributions, but also content about packaging, reviewing, etc.
- configuration/ -- Detailed information about configuring Horizon. This would include all of the settings
  content.

Blueprint information

Status:
Complete
Approver:
Rob Cresswell
Priority:
High
Drafter:
Rob Cresswell
Direction:
Approved
Assignee:
Rob Cresswell
Definition:
Approved
Series goal:
Accepted for 13.0.0-queens
Implementation:
Implemented
Milestone target:
milestone icon queens-rc1
Started by
Rob Cresswell on 2017-06-08
Completed by
Akihiro Motoki on 2018-01-29

Related branches

Sprints

Whiteboard

[amotoki - Jan 29, 2018] the most efforts have been done in Pike and we can improve our docs if we have more topics as a separate bug or blueprint. Let's close it.
[amotoki - Jan 22, 2018] Can we close this blueprint? Is there anything remaining in this blueprint?

----

Gerrit topic: https://review.openstack.org/#q,topic:bp/pike-docs-overhaul,n,z

Addressed by: https://review.openstack.org/472327
    Update the quickstart guide

Addressed by: https://review.openstack.org/472400
    Update example local.conf

Addressed by: https://review.openstack.org/473932
    Update and merge the install / deployment docs

Addressed by: https://review.openstack.org/474265
    Fix the CLI symbol in the quickstart doc

Addressed by: https://review.openstack.org/474430
    doc: better formatting of TOC in sidebar

Addressed by: https://review.openstack.org/482437
    Reorganise and update the settings documentation

Addressed by: https://review.openstack.org/487808
    Update local conf

Addressed by: https://review.openstack.org/493809
    Minor improvements to the translation document

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.