Complete TODOs in api concept doc

Registered by Alex Xu

The api concept was restructure https://review.openstack.org/#/c/226253/, but still left a lot of TODOs, we should complete them. The api concept doc is important for our api user to use nova api without reading nova code.

Blueprint information

Status:
Complete
Approver:
John Garbutt
Priority:
High
Drafter:
Alex Xu
Direction:
Approved
Assignee:
Alex Xu
Definition:
Approved
Series goal:
Accepted for mitaka
Implementation:
Implemented
Milestone target:
milestone icon mitaka-3
Started by
John Garbutt
Completed by
John Garbutt

Related branches

Sprints

Whiteboard

Gerrit topic: https://review.openstack.org/#q,topic:bp/complete-todo-in-api-concept-doc,n,z

Addressed by: https://review.openstack.org/236947
    Add more 'actions' for server concepts doc

Addressed by: https://review.openstack.org/243066
    docs: update the API faults concept guide

Addressed by: https://review.openstack.org/246976
    docs: update the concept guide shelve actions

Addressed by: https://review.openstack.org/247016
    docs: describe migration and other movement concepts

Addressed by: https://review.openstack.org/248063
    Change some wording on server_concepts.rst

Addressed by: https://review.openstack.org/248454
    docs: update services description for concept guide

Addressed by: https://review.openstack.org/248455
    Remove duplicated section about error handling.

Addressed by: https://review.openstack.org/248463
    docs: using the correct format and real world example for fault message

Addressed by: https://review.openstack.org/249321
    docs: add clarifications to move servers

Addressed by: https://review.openstack.org/249331
    docs: reorder move servers

Addressed by: https://review.openstack.org/249731
    Make server concept guide use 'server' consistently

Addressed by: https://review.openstack.org/249757
    api-guide: fix up navigation bar

Addressed by: https://review.openstack.org/249758
    api-guide: add note about users

Addressed by: https://review.openstack.org/249812
    api-guide: add a doc on users

Addressed by: https://review.openstack.org/250199
    Correct some nits for moving servers in concept doc

Addressed by: https://review.openstack.org/250366
    Remove description about image from faults section

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

Addressed by: https://review.openstack.org/249943
    Docs: update the concept guide for Host topics

Addressed by: https://review.openstack.org/250724
    Add user data into general concept

Addressed by: https://review.openstack.org/250737
    Add hypervisor and aggregates brief description

Addressed by: https://review.openstack.org/251383
    doc: add server status to concept.rst

Addressed by: https://review.openstack.org/253292
    Add more TODOs for the api concept docs

Addressed by: https://review.openstack.org/253512
    Add separated section for extra specs and image properties

Addressed by: https://review.openstack.org/253513
    Add separated section for configure guest os

Addressed by: https://review.openstack.org/254466
    Make "ReSTful service" consistent

Addressed by: https://review.openstack.org/254473
    Fix the endpoint of /v2 on concept doc

Addressed by: https://review.openstack.org/254490
    docs: add microversions description in the concept doc

Addressed by: https://review.openstack.org/254537
    docs: add concept guide for certificate

Addressed by: https://review.openstack.org/254549
    Make admin consistent

Addressed by: https://review.openstack.org/254551
    Remove XML description from extension concept

Addressed by: https://review.openstack.org/254687
    docs: update old stuff in version section

Gerrit topic: https://review.openstack.org/#q,topic:complete-todo-in-api-concept-doc,n,z

Addressed by: https://review.openstack.org/254766
    Edit the text to be more native-English sounding

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

Addressed by: https://review.openstack.org/256348
    Remove a restriction on injection files

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

Addressed by: https://review.openstack.org/256351
    Remove incorrect comments about file injection

Addressed by: https://review.openstack.org/259565
    Add description for server query

Addressed by: https://review.openstack.org/263220
    doc: completes microversion use-case in api concept doc

Addressed by: https://review.openstack.org/264044
    doc: add version discovery guideline in api concept doc

Addressed by: https://review.openstack.org/264045
    doc: add client interactive guideline for microversions

Addressed by: https://review.openstack.org/267370
    doc: remove the detail about extensions and point to microversions

Addressed by: https://review.openstack.org/273376
    Add description for trigger crash dump

All current patches are merged, so we are probably done for mitaka at this point.
We can track any more fixes outside this blueprint.
--johnthetubaguy 2016.02.10

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.