nova/doc
Matt Riedemann c55eff39f2 doc: fix and clarify --block-device usage in user docs
The docs on create a volume-backed server from the command
line were wrong in a few ways:

* The openstack server create command does not currently allow
  booting from a volume where a source image is provided and
  nova creates the volume from the image and uses that volume
  as the root disk. The nova boot command supports that, so the
  docs are updated to call out the nova boot command since that
  is the appropriate command in this case (even the syntax with
  the openstack server create --block-device was wrong).

* When creating a server from a bootable volume with the OSC CLI,
  either the --volume or --block-device options should be used
  for a single volume, but not both. The docs were using both, so
  the latter is dropped and a note is added which links to the CLI
  documentation for more details on --block-device option usage.

Change-Id: I985b870759d6c21ef9357b04f39099c02354f135
Closes-Bug: #1794827
(cherry picked from commit 16027094eb)
(cherry picked from commit 6a6d0e9434)
2019-11-14 11:59:51 -05:00
..
api_samples Fix os-simple-tenant-usage result order 2019-01-22 18:09:21 +01:00
ext Fix the usage of instance.snapshot notification sample 2017-11-21 11:03:52 +00:00
notification_samples Null out instance.availability_zone on shelve offload 2018-09-28 14:07:15 -04:00
source doc: fix and clarify --block-device usage in user docs 2019-11-14 11:59:51 -05:00
test add whereto for testing redirect rules 2017-10-30 12:37:23 -04:00
README.rst Fix the file name of development-environment.rst 2018-06-11 09:00:25 +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.