openstack/openstack-ansible
Code Issues Proposed changes

docs: Remove all the unnecessary blockquotes

Browse Source 
This change removes all unnessary blockquotes in the generated
html documentation. This was caused by too much whitespace before
doing lists or code blocks. Those blockquotes are easy to grep with:

    $ grep -n -R "<blockquote>" --include "*.html"

There is one blockquote left (bug-triage.rst), which is indeed a
paragraph which can be quoted.

Change-Id: Ib84ee3fb95caf2e9a545e1d89f22faf63304ad43
This commit is contained in:
Markus Zoeller 2017-05-31 13:18:24 +02:00
parent 215bb56fb3
commit a8aba563c7
12 changed files with 150 additions and 150 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/source/developer-docs/contribute.rst
View File

@ -260,7 +260,7 @@ using the YAML dictionary format.
Example YAML dictionary format:
.. code-block:: yaml
.. code-block:: yaml
- name: The name of the tasks
module_name:
@ -273,13 +273,13 @@ Example YAML dictionary format:
Example what **NOT** to do:
.. code-block:: yaml
.. code-block:: yaml
- name: The name of the tasks
module_name: thing1="some-stuff" thing2="some-other-stuff"
tags: some-tag
.. code-block:: yaml
.. code-block:: yaml
- name: The name of the tasks
module_name: >

6
doc/source/developer-docs/inventory.rst
View File

@ -49,13 +49,13 @@ any previous contents in the event of conflicts.
The following file must be present in the configuration directory:
* ``openstack_user_config.yml``
* ``openstack_user_config.yml``
Additionally, the configuration or environment could be spread between two
additional sub-directories:
* ``conf.d``
* ``env.d`` (for environment customization)
* ``conf.d``
* ``env.d`` (for environment customization)
The dynamic inventory script does the following:

4
doc/source/inventory/configure-inventory.rst
View File

@ -45,8 +45,8 @@ Group memberships
When adding groups, keep the following in mind:
* A group can contain hosts
* A group can contain child groups
* A group can contain hosts
* A group can contain child groups
However, groups cannot contain child groups and hosts.

6
doc/source/inventory/inventory.rst
View File

@ -41,13 +41,13 @@ any previous contents in the event of conflicts.
The following file must be present in the configuration directory:
* ``openstack_user_config.yml``
* ``openstack_user_config.yml``
Additionally, the configuration or environment could be spread between two
additional sub-directories:
* ``conf.d``
* ``env.d`` (for environment customization)
* ``conf.d``
* ``env.d`` (for environment customization)
The dynamic inventory script does the following:

2
doc/source/operations-guide/maintenance-tasks/scale-environment.rst
View File

@ -177,7 +177,7 @@ Recover a compute host failure
The following procedure addresses Compute node failure if shared storage
is used.
.. note::
.. note::
If shared storage is not used, data can be copied from the
``/var/lib/nova/instances`` directory on the failed Compute node

30
doc/source/operations-guide/openstack-operations/cli-operations.rst
View File

@ -10,26 +10,26 @@ Log in to any utility container to run the following commands:
List images
~~~~~~~~~~~
The :command:`openstack image list` command shows details about currently
available images:
The :command:`openstack image list` command shows details about currently
available images:
.. code::
.. code::
$ openstack image list
+------------------+--------------+--------+
| ID | Name | Status |
+------------------+--------------+--------+
| [ID truncated] | ExampleImage | active |
| [ID truncated] | ExaeImage | active |
+------------------+--------------+--------+
List compute services
~~~~~~~~~~~~~~~~~~~~~
The :command:`openstack compute service list` command details the currently
running compute services:
The :command:`openstack compute service list` command details the currently
running compute services:
.. code::
.. code::
$ openstack compute service list
+------------------+------------+----------+---------+-------+----------------------------+
@ -45,11 +45,11 @@ List compute services
List flavors
~~~~~~~~~~~~
The **openstack flavor list** command lists the *flavors* that are
available. These are different disk sizes that can be assigned to
images:
The **openstack flavor list** command lists the *flavors* that are
available. These are different disk sizes that can be assigned to
images:
.. code::
.. code::
$ openstack flavor list
+-----+-----------+-------+------+-----------+-------+-----------+
@ -66,11 +66,11 @@ List flavors
List floating IP addresses
~~~~~~~~~~~~~~~~~~~~~~~~~~
The **openstack floating ip list** command lists the currently
available floating IP addresses and the instances they are
associated with:
he **openstack floating ip list** command lists the currently
available floating IP addresses and the instances they are
associated with:
.. code::
.. code::
$ openstack floating ip list
+------------------+------------------+---------------------+------------ +

2
doc/source/operations-guide/openstack-operations/managing-images.rst
View File

@ -23,7 +23,7 @@ In order to add an image using the Dashboard, prepare an image binary
file, which must be accessible over HTTP using a valid and direct URL.
Images can be compressed using ``.zip`` or ``.tar.gz``.
.. note::
.. note::
Uploading images using the Dashboard will be available to users
with administrator privileges. Operators can set user access

14
doc/source/operations-guide/openstack-operations/managing-instances.rst
View File

@ -203,7 +203,7 @@ The **Actions** column includes the following options:
- Soft or hard reset the instance
.. note::
.. note::
Terminate the instance under the **Actions** column.
@ -222,9 +222,9 @@ Nova instances live migration
Nova is capable of live migration instances from one host to
a different host to support various operational tasks including:
* Host Maintenance
* Host capacity management
* Resizing and moving instances to better hardware
* Host Maintenance
* Host capacity management
* Resizing and moving instances to better hardware
Nova configuration drive implication
@ -271,9 +271,9 @@ URL for how to transfer the data from one host to the other.
Depending on the ``nova_virt_type`` override the following configurations
are used:
* kvm defaults to ``qemu+tcp://%s/system``
* qemu defaults to ``qemu+tcp://%s/system``
* xen defaults to ``xenmigr://%s/system``
* kvm defaults to ``qemu+tcp://%s/system``
* qemu defaults to ``qemu+tcp://%s/system``
* xen defaults to ``xenmigr://%s/system``
Libvirt TCP port to transfer the data to migrate.

18
doc/source/operations-guide/openstack-operations/network-service.rst
View File

@ -11,19 +11,19 @@ Load-Balancer-as-a-Service (LBaaS)
Understand the following characteristics of the OpenStack-Ansible LBaaS
technical preview:
* The preview release is not intended to provide highly scalable or
* The preview release is not intended to provide highly scalable or
highly available load balancing services.
* Testing and recommended usage is limited to 10 members in a pool
* Testing and recommended usage is limited to 10 members in a pool
and no more than 20 pools.
* Virtual load balancers deployed as part of the LBaaS service are
* Virtual load balancers deployed as part of the LBaaS service are
not monitored for availability or performance.
* OpenStack-Ansible enables LBaaS v2 with the default HAProxy-based agent.
* The Octavia agent is not supported.
* Integration with physical load balancer devices is not supported.
* Customers can use API or CLI LBaaS interfaces.
* The Dashboard offers a panel for creating and managing LBaaS load balancers,
* OpenStack-Ansible enables LBaaS v2 with the default HAProxy-based agent.
* The Octavia agent is not supported.
* Integration with physical load balancer devices is not supported.
* Customers can use API or CLI LBaaS interfaces.
* The Dashboard offers a panel for creating and managing LBaaS load balancers,
listeners, pools, members, and health checks.
* SDN integration is not supported.
* SDN integration is not supported.
Since Mitaka, you can `enable Dashboard (horizon) panels`_ for LBaaS.
Additionally, a deployer can specify a list of servers behind a

10
doc/source/operations-guide/troubleshooting.rst
View File

@ -507,9 +507,9 @@ Cached Ansible facts issues
At the beginning of a playbook run, information about each host is gathered,
such as:
* Linux distribution
* Kernel version
* Network interfaces
* Linux distribution
* Kernel version
* Network interfaces
To improve performance, particularly in large deployments, you can
cache host facts and information.
@ -572,7 +572,7 @@ Predictable interface naming
On the host, all virtual Ethernet devices are named based on their
container as well as the name of the interface inside the container:
.. code-block:: shell-session
.. code-block:: shell-session
${CONTAINER_UNIQUE_ID}_${NETWORK_DEVICE_NAME}
@ -583,7 +583,7 @@ will have two network interfaces: `d13b7132_eth0` and `d13b7132_eth1`.
Another option would be to use the LXC tools to retrieve information
about the utility container. For example:
.. code-block:: shell-session
.. code-block:: shell-session
# lxc-info -n aio1_utility_container-d13b7132

6
doc/source/upgrade-guide/minor-upgrade.rst
View File

@ -78,18 +78,18 @@ component playbooks against groups.
For example, you can update only the Compute hosts by running the following
command:
.. code-block:: console
.. code-block:: console
# openstack-ansible os-nova-install.yml --limit nova_compute
To update only a single Compute host, run the following command:
.. code-block:: console
.. code-block:: console
# openstack-ansible os-nova-install.yml --limit <node-name> \
--skip-tags 'nova-key'
.. note::
.. note::
Skipping the ``nova-key`` tag is necessary so that the keys on
all Compute hosts are not gathered.