cinder/doc/source/contributor/index.rst
Walter A. Boring IV e10b094db4 Add pdf documentation build in tox
This patch adds a new tox job/command for building the pdf version
of documentation.

tox -epdf-docs

In addition to adjusting the infra requirement for PDF build support,
the following changes are made to build a PDF doc.

- Inline sample config file is skipped for PDF doc
  to avoid an LaTeX error "TeX capacity exceeded".
- Download link of sample config and policy files are disabled
  for PDF doc as relative links do not make sense.
- "Search" and "genindex" page is only enabled for HTML doc
  as they work only for HTML doc.

Co-Authored-By: Akihiro Motoki <amotoki@gmail.com>
Change-Id: Ib8ce96f4d043dcf0cfe6d3f8b64879f07bc5958c
2019-08-28 20:37:56 +00:00

94 lines
2.0 KiB
ReStructuredText

..
Copyright 2010-2011 United States Government as represented by the
Administrator of the National Aeronautics and Space Administration.
All Rights Reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may
not use this file except in compliance with the License. You may obtain
a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations
under the License.
Contributor Guide
=================
In this section you will find information on how to contribute to Cinder.
Content includes architectural overviews, tips and tricks for setting up a
development environment, and information on Cinder's lower level programming
APIs.
Programming HowTos and Tutorials
--------------------------------
.. toctree::
:maxdepth: 2
development.environment
testing
api_microversion_dev
api_conditional_updates
addmethod.openstackapi
drivers
high_availability
gmr
replication
user_messages
migration
api.apache
rolling.upgrades
groups
Managing the Development Cycle
------------------------------
.. toctree::
:maxdepth: 1
releasecycle
Documentation Contribution
--------------------------
.. toctree::
:maxdepth: 2
documentation
Background Concepts for Cinder
------------------------------
.. toctree::
:maxdepth: 3
architecture
attach_detach_conventions
attach_detach_conventions_v2
thin_provisioning
threading
i18n
rpc
Other Resources
---------------
.. toctree::
:maxdepth: 3
launchpad
gerrit
zuul
releasenotes
Module Reference <api/modules>
.. only:: html
Indices and tables
------------------
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`