Refresh the DevRef and in tree documentation for liberty (partial)

Registered by John Garbutt

Its great to have a record of "tribal" knowledge, lets try keep this up to date. This should include documenting consensus that has been reached, and why. We should focus not on the decision but the reasons behind it, so we know when to revisit that.

In addition, we will look at documenting multi-release efforts and "roadmap" like plans.

We need to kick start mentoring and getting started guides so its clear how to get involved.

We need to consolidate some things:
http://docs.openstack.org/developer/nova/
http://docs.openstack.org/developer/nova/blueprints.html
http://specs.openstack.org/openstack/nova-specs/
https://git.openstack.org/cgit/openstack/nova-specs/tree/README.rst
https://wiki.openstack.org/wiki/Nova/Mentoring
https://wiki.openstack.org/wiki/Nova/Liberty_Release_Schedule
https://wiki.openstack.org/wiki/Nova
https://wiki.openstack.org/wiki/Nova/BugTriage
(and more...)

Note, where possible, just link to stuff that is external to Nova:
http://docs.openstack.org/infra/manual/developers.html
https://github.com/openstack/project-team-guide

Blueprint information

Status:
Complete
Approver:
Michael Still
Priority:
Medium
Drafter:
John Garbutt
Direction:
Approved
Assignee:
John Garbutt
Definition:
Approved
Series goal:
Accepted for liberty
Implementation:
Implemented
Milestone target:
milestone icon 12.0.0
Started by
John Garbutt
Completed by
John Garbutt

Related branches

Sprints

Whiteboard

Approved as trivial at the 7 May Nova meeting.

Addressed by: https://review.openstack.org/178623
    devref: add information to clarify nova scope

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

Addressed by: https://review.openstack.org/177374
    devref: update the nova architecture doc

Addressed by: https://review.openstack.org/178635
    devref: discuss current state of error handling

Addressed by: https://review.openstack.org/178628
    devref: add a description of flavors

Gerrit topic: https://review.openstack.org/#q,topic:bp/devref-refresh-liberty,n,z

Gerrit topic: https://review.openstack.org/#q,topic:docs/bugs,n,z

Addressed by: https://review.openstack.org/187571
    WIP: docs: Add bug handling description to developer reference

Gerrit topic: https://review.openstack.org/#q,topic:devref/vmstates,n,z

Addressed by: https://review.openstack.org/191021
    devref: virtual machine states and transitions

Addressed by: https://review.openstack.org/192259
    docs: clear between current vs future plans

Addressed by: https://review.openstack.org/192260
    docs: add the scheduler evolution plans

Addressed by: https://review.openstack.org/192651
    Add documentation for block device mapping

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

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

Addressed by: https://review.openstack.org/194840
    Replace ascii art architecture diagram with svg image

Addressed by: https://review.openstack.org/200001
    Add a summary of the architecture evolution work

Addressed by: https://review.openstack.org/200053
    docs: add a placeholder link to mentoring docs

Addressed by: https://review.openstack.org/201529
    docs: split up upgrade and upgrade futures

Alexis rewrote the "I got stuck, help" bit of wiki:
    https://review.openstack.org/#/c/206070/

Addressed by: https://review.openstack.org/190324
    Fix overloading of block device on boot by device name

Addressed by: https://review.openstack.org/215664
    docs: add the concept of Feature Classifcation

This all developer docs, so it can happen in the RC timeframe. --johnthetubaguy 28th August 2015

Marking as partially complete, such that we can RC1 cut. --johnthetubaguy 22nd September 2015

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.

Subscribers

No subscribers.