Rework the Kolla Documentation

Registered by Ryan Hallisey

The kolla docs are unclear and incomplete. We need to work with all the new members in the community to help build better docs.

https://etherpad.openstack.org/p/kolla-newton-summit-documentation-planning

Blueprint information

Status:
Complete
Approver:
Ryan Hallisey
Priority:
Essential
Drafter:
Ryan Hallisey
Direction:
Approved
Assignee:
Ryan Hallisey
Definition:
Approved
Series goal:
Accepted for ocata
Implementation:
Implemented
Milestone target:
milestone icon pike-3
Started by
Ryan Hallisey
Completed by
Jeffrey Zhang

Related branches

Sprints

Whiteboard

Gerrit topic: https://review.openstack.org/#q,topic:bp/documentation-rework,n,z

Addressed by: https://review.openstack.org/311884 (MERGED)
    Doc rework for quickstart, multinode, and image-building

Addressed by: https://review.openstack.org/315405 (MERGED)
    Update advanced configuration

Addressed by: https://review.openstack.org/315407 (MERGED)
    Update Cinder guide

Addressed by: https://review.openstack.org/317205 (MERGED)
    Update quickstart guide for formatting

Gerrit topic: https://review.openstack.org/#q,topic:bug/1582618,n,z

Addressed by: https://review.openstack.org/318113 (MERGED)
    Change the SELinux doc to a security doc

Addressed by: https://review.openstack.org/317084 (MERGED)
    Document upgrading for operators

Addressed by: https://review.openstack.org/315390 (MERGED)
    Simplify image building information in quickstart

Addressed by: https://review.openstack.org/319292 (MERGED)
    Document using a custom config directory

Addressed by: https://review.openstack.org/318648 (MERGED)
    Make configurable the location where config files are merged

Addressed by: https://review.openstack.org/319585 (MERGED)
    Specify registry volume location

Addressed by: https://review.openstack.org/319592
    Cleanup Advanved Configuration doc

Addressed by: https://review.openstack.org/319899 (MERGED)
    Update Documentation

Addressed by: https://review.openstack.org/320933 (MERGED)
    Update the image-building documentation

Addressed by: https://review.openstack.org/328069 (MERGED)
    Added test document

Addressed by: https://review.openstack.org/329015 (MERGED)
    The quickstart guide still says to use Anisble 1.9.4 which no longer works with Kolla.

Gerrit topic: https://review.openstack.org/#q,topic:bug/1585995,n,z

Midcycle discussion:
https://etherpad.openstack.org/p/kolla-N-midcycle-docs

Addressed by: https://review.openstack.org/343223
    Add docs for host setup

Addressed by: https://review.openstack.org/343224
    Shrink the quickstart massively and break it into 2

Addressed by: https://review.openstack.org/348029 (MERGED)
    Build a more organized doc structure

Addressed by: https://review.openstack.org/356222 (MERGED)
    Add guide to auto mount /run as shared

Addressed by: https://review.openstack.org/406473 (ABANDONED)
    Update documentation to reflect repo split

Addressed by: https://review.openstack.org/409608 (MERGED)
    Remove `$` character for document consistency.

Addressed by: https://review.openstack.org/435217 (MERGED)
    Update running-tests.rst file

(?)

Work Items

Work items:
(unassigned): Philosophy Document: TODO
(unassigned): Architecture overview: TODO
(sdake): setup host: centos: TODO
(inc0): setup host: ubuntu: TODO
(unassigned): Always setup registry: TODO
(unassigned): Kolla quickstart ( AIO ): TODO
(unassigned): I am operator ( on metal ): TODO
(unassigned): I am kolla developer: TODO
(unassigned): Kolla as devstack+1 (separate discussion): TODO
(unassigned): Kolla on vagrant: TODO
(unassigned): Kolla on OpenStack(fix the heat support?): TODO
(unassigned): Advanced Configuration: TODO
(unassigned): Document inventory file: TODO
(unassigned): Buliding custom container images: TODO
(unassigned): Configuration in globals.yml: TODO
(unassigned): deploying behind proxies: TODO
(unassigned): deploy in ip constrianed enviroment(no haproxy): TODO
(unassigned): advanced deployment: TODO
(unassigned): Multinode Deployment: TODO
(unassigned): (tangent) migrate from AIO to multinode: TODO
(unassigned): kolla-ansbile deploy with all options: TODO
(unassigned): Post deployment operations: TODO
(unassigned): upgrade with all options: TODO

This blueprint contains Public information 
Everyone can see this information.

Subscribers

No subscribers.