nova/doc
Dan Smith 104c9e6375 Clarify/correct the ordering of API and Cell database schema updates
Everyone seems to agree that the only sane ordering of these operations
is "api first, cell after." However, grenade and our own documentation
shows the api database as coming after the main one. I believe this
was added to grenade in a sort of append operation, and thus after the
main database. This was done back when usage of the API database was
still optional (for upgrades) and thus the ordering didn't matter much.
Since the process has been correct (api first) in devstack for a long
time, and since grenade runs after devstack, we haven't had any issues.
A recent change to add something to a core data structure column format
highlighted the out-of-order-ness of this.

I also believe the docs got the same append behavior when adding the
command to the list, and/or it may have been copied from grenade, which
is our in-code manifestation of the upgrade steps.

Change-Id: I19f263ed314a8b01bbb07337467392cc1c146b66
Related-Bug: #1761775
2018-04-06 08:24:33 -07:00
..
api_samples Merge "Address nits in change I7e01f95d7173d9217f76e838b3ea71555151ef56" 2018-03-01 12:55:57 +00:00
ext Python 3 fix for sphinx doc 2018-02-15 14:26:45 +01:00
notification_samples Merge "Transform live_migration.post.dest notifications" 2018-03-13 16:10:31 +00:00
source Clarify/correct the ordering of API and Cell database schema updates 2018-04-06 08:24:33 -07:00
test doc: merge numa.rst to cpu-topologies.rst 2018-02-10 17:50:16 +09:00
README.rst Fix broken URLs 2017-09-07 15:42:31 +02:00
requirements.txt Updated from global requirements 2018-03-17 08:48:15 +00:00

README.rst

OpenStack Nova Documentation README

Both contributor developer documentation and REST API documentation are sourced here.

Contributor developer docs are built to: https://docs.openstack.org/nova/latest/

API guide docs are built to: https://developer.openstack.org/api-guide/compute/

For more details, see the "Building the Documentation" section of doc/source/contributor/development.environment.rst.