de7aff63b8
Change [1] introduced a remote image link in our README.rst. Due to the fact that we include this README in our docs, our 'tox -e docs' build now fails due to the nonlocal image URI as we run the sphinx build with -W: -- Warning, treated as error: README.rst:None: WARNING: nonlocal image URI found: http://governance.openstack.org/badges/neutron-lib.svg -- Ignoring specific warnings is supported with newer versions of sphinx [2], but not with the version we currently use. Therefore this patch removes our readme reference from our doc/source/ tree. [1] https://review.openstack.org/#/c/402702/ [2] https://github.com/sphinx-doc/sphinx/issues/2466 Change-Id: I8458635f7081ea98a160cbb4105032d435bdcb98
63 lines
2.1 KiB
ReStructuredText
63 lines
2.1 KiB
ReStructuredText
..
|
|
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.
|
|
|
|
Welcome to Neutron Lib developer documentation!
|
|
===============================================
|
|
|
|
Neutron-lib is an OpenStack library project used by Neutron, Advanced Services,
|
|
and third-party projects that aims to provide common functionality across all
|
|
such consumers. The library is developed with the following goals in mind:
|
|
|
|
- Decouple sub-projects from Neutron (i.e. no direct neutron imports in
|
|
sub-projects).
|
|
- Pay down Neutron technical debt via refactoring/re-architecting of
|
|
sub-optimal patterns in their respective neutron-lib implementation.
|
|
|
|
This document describes the library for contributors of the project, and assumes
|
|
that you are already familiar with Neutron from an `end-user perspective`_.
|
|
|
|
.. _`end-user perspective`: http://docs.openstack.org/trunk/openstack-network/admin/content/index.html
|
|
|
|
This documentation is generated by the Sphinx toolkit and lives in the source
|
|
tree. Additional documentation on Neutron and other components of OpenStack
|
|
can be found on the `OpenStack wiki`_ and the `Neutron section of the wiki`.
|
|
The `Neutron Development wiki`_ is also a good resource for new contributors.
|
|
|
|
.. _`OpenStack wiki`: http://wiki.openstack.org
|
|
.. _`Neutron section of the wiki`: http://wiki.openstack.org/Neutron
|
|
.. _`Neutron Development wiki`: http://wiki.openstack.org/NeutronDevelopment
|
|
|
|
Enjoy!
|
|
|
|
|
|
Programming HowTos and Tutorials
|
|
--------------------------------
|
|
.. toctree::
|
|
:maxdepth: 3
|
|
|
|
conventions
|
|
installation
|
|
usage
|
|
review-guidelines
|
|
contributing
|
|
releasing
|
|
|
|
|
|
Developer Docs
|
|
==============
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
devref/index
|