openstack/kolla-ansible
Code Issues Proposed changes

Add the full name of PBR in its first usage

Browse Source 
This warning message mentions PBR, but this is the first
instance of this acronym in the documentation. Use the full
name can be made clear what PBR stands for in its first usage.

Change-Id: I46c7db79eb330e7f58d71afd6c749dd27e2c0f80
Closes-Bug: 1729476
This commit is contained in:
chenxing 2017-11-02 16:56:34 +08:00
parent 214866350a
commit 9ff89025c9
1 changed files with 9 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/source/user/quickstart.rst
View File

@ -170,14 +170,15 @@ requirements it can be installed by:
.. WARNING::
Kolla uses PBR in its implementation. PBR provides version information
to Kolla about the package in use. This information is later used when
building images to specify the Docker tag used in the image built. When
installing the Kolla package via pip, PBR will always use the PBR version
information. When obtaining a copy of the software via git, PBR will use
the git version information, but **ONLY** if Kolla has not been pip
installed via the pip package manager. This is why there is an operator
workflow and a developer workflow.
Kolla uses `Python Build Reasonableness (PBR) <https://docs.openstack.org/pbr/latest/>`_
in its implementation. ``PBR`` provides version information to Kolla about
the package in use. This information is later used when building images to
specify the Docker tag used in the image built. When installing the Kolla
package via pip, ``PBR`` will always use the ``PBR`` version information.
When obtaining a copy of the software via git, ``PBR`` will use the git
version information, but **ONLY** if Kolla has not been pip installed via
the pip package manager. This is why there is an operator workflow and a
developer workflow.
The following dependencies can be installed by bootstraping the host machine
as described in the `Automatic host bootstrap`_ section. For manual