index: reformat table of contents

Make TOC sections more obvious and remove single include file for
contribution and development.
This commit is contained in:
Christian Poessinger 2019-11-08 17:40:32 +01:00
parent 477f5717da
commit 7d3a19bcad
2 changed files with 65 additions and 47 deletions

View File

@ -1,12 +0,0 @@
.. _contributing_index:
.. toctree::
:maxdepth: 2
:hidden:
issues_features
development
vyos_cli
coding_guidelines
upstream-packages
build-vyos

View File

@ -10,10 +10,26 @@ commercially available solutions from well known network providers. Because
VyOS is run on standard amd64, i586 and ARM systems, it is able to be used
as a router and firewall platform for cloud deployments.
#####
About
#####
We use multiple live versions of our manual hosted thankfully by
https://readthedocs.org. We will provide one version of the manual for every
VyOS major version starting with VyOS 1.2 which will receive Long-term support
(LTS).
The manual version is selected/specified by it's Git branch name. You can
switch between versions of the documentation by selecting the appropriate
branch on the bottom left corner.
############
Introduction
############
.. _introduction:
.. toctree::
:maxdepth: 2
:caption: Contents:
:includehidden:
history.rst
install.rst
@ -33,11 +49,16 @@ as a router and firewall platform for cloud deployments.
load-balancing.rst
image-mgmt.rst
commandscripting.rst
.. modules
########
Appendix
########
.. _appendix:
.. toctree::
:maxdepth: 2
:caption: Appendix:
:includehidden:
appendix/releasenotes.rst
appendix/troubleshooting.rst
@ -47,12 +68,21 @@ as a router and firewall platform for cloud deployments.
appendix/vyos-on-baremetal.rst
appendix/migrate-from-vyatta.rst
############
Contributing
############
.. _contributing:
.. toctree::
:maxdepth: 2
:caption: Contributing:
:includehidden:
contributing/index.rst
contributing/issues_features
contributing/development
contributing/vyos_cli
contributing/coding_guidelines
contributing/upstream-packages
contributing/build-vyos
################