Add links to refer to the main Kolla documentation. Also fix minor
formatting errors that were preventing the docs from building.

Change-Id: I8759b9e995097d221900441bd001a1234ae007fd
Depends-On: Ia7959c71a241b9d7139ec50b34e36b24fbcf76e6
Co-Authored-By: Mauricio Lima <mauriciolimab@gmail.com>

Improvement to the existing Multinode Deployment Guide

Change-Id: I55d1bb174459bb705fa1106e231a28836ba0af6e

Adding -e REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io to the
docker run command in the start-registry script configures the local
registry as a pull through cache. However, pushing of images to the
local registry fails.

Pushing to a registry configured as a pull-through cache is unsupported.
For more information, reference the proxy section in Docker
Documentation (https://docs.docker.com/registry/configuration/)

The start_registry script has been updated in the patch set
https://review.openstack.org/#/c/426338/

Change-Id: If62b40d8316af7c3593523493cad8a904d35dceb

Get follwing error when running tox -edocs

doc/bifrost.rst:91: D001 Line too long
doc/manila-hnas-guide.rst:28: D000 Title underline too short.
doc/manila-hnas-guide.rst:28: D000 Title underline too short.
doc/networking-guide.rst:93: D000 Title underline too short.
doc/networking-guide.rst:93: D000 Title underline too short.
doc/multinode.rst:14: D001 Line too long
doc/quickstart.rst:474: D001 Line too long
doc/vagrant-dev-env.rst:129: D001 Line too long

Change-Id: I88090487a4710547224361d29aaf8371f8340c28

Update documents reference image-building documents correctly after
image-building.rst was deleted from kolla-ansible directory.

Change-Id: Ib66475e1f0f3055f2e38fc33ae649cae300c9c36

Kolla-ansible related documents existed on both Kolla and Kolla-Ansible
repositories. A lot of Kolla-ansible related documents were updated in
the Kolla repository. Porting the changes made to these documents in
Kolla repo to Kolla-Ansible repo so that the Kolla-ansible documents can
be removed (Refer to patch https://review.openstack.org/#/c/425749/)

Change-Id: I7c53626ce551189acdb0dcbabe9369b81eed3347

TrivialFix

Change-Id: I47ac48bd5fc07b3bc9fd43c249de0fba8b030076

Changed occurences of 'docker' to 'Docker' to be in accordance
with Docker Inc's trademark guidelines found here:

https://www.docker.com/trademark-guidelines

This was done due to a pending change that will append Docker
Inc's trademark notice in the kolla docs

TrivialFix

Change-Id: Ie3f385897bfa604986bd99329c0f4b961d3c8552

It was pointed out that the MountFlags=shared entry
was missing for Ubuntu in the multinode deployment guide.
The entry has been added back in.

Change-Id: I164932848eeaec3963fa205d4493a3b7f2343dfd
Closes-Bug: #1640618

Since initial setup is arguably the hardest part of kolla deployment,
let's show people our new plabybook to lower the barrier of entry.

TrivialFix

Change-Id: I6edf355772b5705207cdecfbe8c45672a63badf0

Change-Id: If2aef9629dc7fb380358de8c32c46577b6054f1f
Closes-Bug:  #1624582

Change-Id: I73c22055bd332a788cde05132b98b5561a90e68a

Change-Id: Ie3a7256265f2b1a05c1af1e887b48d48c140c022
Signed-off-by: Zhou Ya <zhou.ya@zte.com.cn>

1.remove the # - it makes copy and paste very difficult
2.change "ubuntu" to "Ubuntu"
3.add "Restart docker by executing the following commands: "

TrivialFix
Change-Id: I0192d9fd7f597b0e2dc8d26d4fe5ba8b32483ce0

This will test all rst files inside the doc directory for style issues with
doc8 (an opinionated style checker for rst styles of documentation).

This will fix all syntax issues identified by doc8 and will improve
the syntax.

Change-Id: Id1b9563e07e77e306aef5a0767c98c27f87c5c0e

The documentation was saying of installing registry 2.3 but
the tag used is registry:2. This tag gets updated to the recent
versions of registry, and hence, this fix was required.
Closes-Bug: 1598231

Change-Id: I3c37c3564678467402223a48c69a1ae7ccbaeebb

Current documentation was outdated/misleading. For CentOS, I found
that they have INSECURE_REGISTRY flag in /etc/sysconfig/docker in
docker version 1.10.3. For Ubuntu, latest versions of ubuntu use
systemd and hence, the documentation needs to be updated.
Closes-Bug: 1598252

Change-Id: I418dc696c09db669501ebfafc6ebf6c48b6f0caf

Applying RST formatting conventions [1],[2] and [3]
[1] http://docs.openstack.org/contributor-guide/rst-conv/gen-guidelines.html
[2] http://docs.openstack.org/contributor-guide/rst-conv/inline-markups.html
[3] http://docs.openstack.org/contributor-guide/rst-conv/lists.html
Change-Id: I38b77a45d30ca0542058675dd1e8aba790c68567
Partially-implements: blueprint documentation-rework

Restructured the documenation to

1. Add reference at the top
2. Updated the title formatting
3. Updated the heading formatting
4. Updated the links formatting

Change-Id: Ie3786e92fee674da1fa39cf07f1bf0a3badd5b92

Our quickstart guide is way too complex.  We need to simplify
the quickstart guide by pulling out the overwhelming amount of
information and splitting it into other docs.

Change-Id: Iec175ee7f60bfd11ce06b22c861e51e180c188a9
Partially-implements: blueprint documentation-rework