Stephen Finucane
59dd49978c
Both the 'api_db' and 'db' categories / commands define a 'sync' (sub)command which takes an optional '--version' parameter. We want to start using 'cliff' in Queens, but that framework does not support command-level parameters with the exception of '--help' [1]. If you think of something like the 'ls' command, you can run it without any arguments and assume a default of the current directory, or you can specify the argument. In the same way, these commands should really be using optional parameters instead of positional arguments. We do this and add aliases for the older parameters to ease with the transition. These aliases are deprecated, raise warnings and will be removed in the move to cliff. [1] https://bugs.launchpad.net/python-cliff/+bug/1619708 Change-Id: I3fd9fe0317bcd1a59c366e60154b095e8df92327 Partially-Implements: bp move-nova-cmds-to-cliff
========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/badges/nova.svg
:target: https://governance.openstack.org/reference/tags/index.html
.. Change things from this point on
OpenStack Nova
==============
OpenStack Nova provides a cloud computing fabric controller,
supporting a wide variety of compute technologies, including:
libvirt (KVM, Xen, LXC and more), Hyper-V, VMware, XenServer
and OpenStack Ironic.
OpenStack Nova is distributed under the terms of the Apache
License, Version 2.0. The full terms and conditions of this
license are detailed in the LICENSE file.
API
---
To learn how to use Nova's API, consult the documentation
available online at:
https://developer.openstack.org/api-guide/compute/
https://developer.openstack.org/api-ref/compute/
For more information on OpenStack APIs, SDKs and CLIs,
please see:
https://www.openstack.org/appdev/
https://developer.openstack.org/
Operators
---------
To learn how to deploy and configure OpenStack Nova, consult the
documentation available online at:
https://docs.openstack.org
For information about the different compute (hypervisor) drivers
supported by Nova, please read:
https://docs.openstack.org/developer/nova/feature_classification.html
In the unfortunate event that bugs are discovered, they should
be reported to the appropriate bug tracker. If you obtained
the software from a 3rd party operating system vendor, it is
often wise to use their own bug tracker for reporting problems.
In all other cases use the master OpenStack bug tracker,
available at:
https://bugs.launchpad.net/nova
Developers
----------
For information on how to contribute to Nova, please see the
contents of the CONTRIBUTING.rst.
Any new code must follow the development guidelines detailed
in the HACKING.rst file, and pass all unit tests.
Further developer focused documentation is available at:
https://docs.openstack.org/developer/nova/