Change index to ease identify what service want to look.
Split docs into more specific folder such as networking
and storage.

Change-Id: Ic7ac12b3dd555fa5c018eeb897ccd4a5a2dfe8f3

Following by https://review.openstack.org/#/c/605097/
These were used by now-dead tooling. We can remove them.

Change-Id: I0953751044f038a3fdd1acd49b3d2b053ac4bec8

Fix typo in doc/source/reference/swift-guide.rst

Change-Id: I9e355a5e8ec6c106c15f8480c7322cf6b33a7d4d

For compliance with the Project Testing Interface [1]
as described in [2]

[1]
https://governance.openstack.org/tc/reference/project-testing-interface.html
[2]
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

doc8 command is dropped from docs tox envs.
So this affect nothing and run in PEP8.

Related-Bug: #1765348

Depends-On: Icc7fe3a8f9716281de88825e9d5b2fd84de3d00a
Change-Id: Idf9a16111479ccc64004eac9508da575822a3df5

We upgrade the rst convention by following Documentation Contributor
Guide[1].

[1] https://docs.openstack.org/doc-contrib-guide

Change-Id: I0e4184e24210f920ea5e7b33e4878385a0758a01
Implements: blueprint optimize-the-documentation-format

In kolla-ansible "quick start" document, the python-openstackclient
is recommended. It is better to validate Swift with "openstack"
commands instead of "swift" commands.

Change-Id: I6287b40f702de2f3c270109803fad8d93a903c01
Closes-Bug: #1732857
Signed-off-by: Tone Zhang <tone.zhang@arm.com>

For more detail, see the doc migration spec.
http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html



Co-Authored-By: Eduardo Gonzalez <dabarren@gmail.com>
Change-Id: I3a7c0ed204ee1e9060b5325f20622afe9a5e3040

Kolla-ansible command miss inventory file paramter in
deploying part for swift-guide.rst file.

Change-Id: I33267549e2c7740c8ced8232de379bdc5502e9f7

The sample script provided in the docs to configure rings should add
each storage node the ring, not the control node pointed to by the vip.

Change-Id: I28ad60eb3c07f5da0e04e7780c41a7eed158b6d5

Change-Id: Ie080e64a0232ab2a3116003890c7b0550001db72

- cinder-guide.rst:34: D001 Line too long
- swift-guide.rst:16: D001 Line too long

Change-Id: I32e7aeeaee98b8859f257bf173d24295fbe4dd6b

Change-Id: I7b3705e8bba67649bfbf0950d1724d711c57e042

* Remove references to all-in-one, kolla Swift now works correctly in both
  all-in-one and multinode contexts

* Fixup commands used for generating rings

* General readability improvements

Change-Id: I3ec87068a98ba5397bb6f2feb707bc685181e747

[1] http://lists.openstack.org/pipermail/openstack-dev/2016-June/097227.html

Change-Id: I73af59dcf1e755dbe0579486f1fb0ebe5ca0119c
Closes-Bug: #1592286

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

People commonly want to use loopback devices to evaulate or develop on
Swift.  The steps for this are slightly different than those for
physical block devices.

Also make some small fix ups to the title formatting.

Change-Id: I0c1cb4a261f264dc56bd065ab137e5ee79e773f8

This change let Swift detect and use physical disk for storage. The
old named volume for storage isn't really useful for any serious setup.
Also updated swift-guide.rst accordingly.

Change-Id: I4f577b7b69d8bcd8b3961500946241c65a16db22
Partially-Implements: blueprint swift-physical-disk

Change-Id: I17b4b40a6c49210faa535bdf3032c000daae0e2e

Change-Id: Ib74e69ee7c5755ccae4e2ecb7b976f110bdae7c1
backport: liberty

All services should have a guide that follows the same style as
cinder-guide.rst or swift-guide.rst and all should be named
service-guie.rst.

Change-Id: Iaa75d137d4e159452153f9fe572fe017fe988be4

- avoid hard coding install type and base distro in sample commands
- fix semicolon to actually make for loop work

Change-Id: I15b46fec5b4ebf7987ea22e7c71a44c739f7dee3

The publishing docs expect the documentation to be present in the
/doc directory not the /docs directory.  If the documentation is in
the /docs directory, according to fungi the docs won't be published
properly.

Change-Id: I718fec7e69d298a5cb2376ca4e2455e12169566e
Partially-Implements: blueprint kola-tox-doc

This currently deploys the core services for a working Swift which are
account/container/object/proxy.

I've included some basic docs in docs/swift-related.rst, which gives
usage instructions and more context on this patch. These are really to
give an overview of the state of Swift in Kolla as of now, so unless
there's some major inaccuracy there please don't nitpick it.

Change-Id: Id0c54be3e24c46459c40b16b7020f05bddbe1b19
Implements: blueprint ansible-swift