keystone/doc
Colleen Murphy 74c1d5aa34 Reorganize admin guide
Now that most of the operator docs are consolidated into the admin
guide, it is huge and hard to find things. This patch breaks the guide
into groups to make it a little easier to navigate:

1. Getting started: basics of keystone and initializing a deployment.
2. Configuration: not a replacement for the main config docs but a
   grouping of all discussions on the various config options.
3. Operations: maintenance workflows like upgrading and cleanups
4. Tokens: an important part of keystone
5. RBAC: gets a section to itself
6. Advanced keystone features: grouping of lesser-known/lesser-used,
   not-required features.
7. Authentication mechanisms: various auth methods besides password,
   including the federation guide

Change-Id: I9039b7023d843349154d28ee0ee2c7b9a9eb97ab
2018-12-14 10:08:10 +01:00
..
ext Fix doc generation for python 3 2017-04-17 07:44:47 +02:00
source Reorganize admin guide 2018-12-14 10:08:10 +01:00
Makefile Align with project configs. 2012-03-01 11:42:42 -08:00
README.rst Fixes documentation building 2013-12-13 02:47:37 +00:00
requirements.txt Add introduction section to federation docs 2018-12-11 15:37:06 +01:00

README.rst

Building Docs

Developer documentation is generated using Sphinx. To build this documentation, run the following from the root of the repository:

$ tox -e docs

The documentation will be built at doc/build/.