Browse Source

[doc-migration] Reorganize the Tricircle doc/source folder

1. What is the problem
Doc migration requires that the installation, admin and configuration
guides have to be put into related directories.

2. What is the solution for the problem
Put configuration, install and admin guide into related sub-folders.

3. What the features need to be implemented to the
tricircle to realize the solution
None.

Closes-Bug: #1706190

Change-Id: I1e1909a373e92b29460b364de38cc25aba038776
changes/49/486849/8
Dongfeng Huang 4 years ago
parent
commit
fa53c16b5e
32 changed files with 141 additions and 23 deletions
  1. +0
    -0
      doc/source/admin/api_v1.rst
  2. +3
    -0
      doc/source/admin/cli.rst
  3. +9
    -0
      doc/source/admin/index.rst
  4. +0
    -0
      doc/source/configuration/configuration.rst
  5. +8
    -0
      doc/source/configuration/index.rst
  6. +0
    -4
      doc/source/contributing.rst
  7. +4
    -0
      doc/source/contributor/contributing.rst
  8. +8
    -0
      doc/source/contributor/index.rst
  9. +33
    -15
      doc/source/index.rst
  10. +8
    -0
      doc/source/install/index.rst
  11. +0
    -0
      doc/source/install/installation-cell.rst
  12. +0
    -0
      doc/source/install/installation-guide.rst
  13. +0
    -0
      doc/source/install/installation-manual.rst
  14. +0
    -0
      doc/source/install/multi-pod-installation-devstack.rst
  15. +0
    -0
      doc/source/install/single-pod-installation-devstack.rst
  16. +8
    -0
      doc/source/networking/index.rst
  17. +0
    -0
      doc/source/networking/networking-guide-direct-provider-networks.rst
  18. +0
    -0
      doc/source/networking/networking-guide-local-networking.rst
  19. +0
    -0
      doc/source/networking/networking-guide-multiple-external-networks.rst
  20. +0
    -0
      doc/source/networking/networking-guide-multiple-ns-with-ew-enabled.rst
  21. +0
    -0
      doc/source/networking/networking-guide-single-external-network.rst
  22. +2
    -0
      doc/source/networking/networking-guide.rst
  23. +0
    -0
      doc/source/networking/networking-prerequisites.rst
  24. +1
    -1
      doc/source/networking/networking-scenarios.rst
  25. +0
    -0
      doc/source/networking/networking-terms.rst
  26. +0
    -0
      doc/source/networking/service-function-chaining-guide.rst
  27. +0
    -0
      doc/source/networking/vlan-aware-vms-guide.rst
  28. +0
    -1
      doc/source/readme.rst
  29. +9
    -0
      doc/source/user/index.rst
  30. +2
    -0
      doc/source/user/readme.rst
  31. +2
    -2
      doc/source/user/usage.rst
  32. +44
    -0
      index.rst

doc/source/api_v1.rst → doc/source/admin/api_v1.rst View File


+ 3
- 0
doc/source/admin/cli.rst View File

@ -0,0 +1,3 @@
================================
Command-Line Interface Reference
================================

+ 9
- 0
doc/source/admin/index.rst View File

@ -0,0 +1,9 @@
=====================
Tricircle Admin Guide
=====================
.. toctree::
:maxdepth: 3
api_v1
cli

doc/source/configuration.rst → doc/source/configuration/configuration.rst View File


+ 8
- 0
doc/source/configuration/index.rst View File

@ -0,0 +1,8 @@
=============================
Tricircle Configuration Guide
=============================
.. toctree::
:maxdepth: 3
configuration

+ 0
- 4
doc/source/contributing.rst View File

@ -1,4 +0,0 @@
=============
Contributing
=============
.. include:: ../../CONTRIBUTING.rst

+ 4
- 0
doc/source/contributor/contributing.rst View File

@ -0,0 +1,4 @@
============
Contributing
============
.. include:: ../../../CONTRIBUTING.rst

+ 8
- 0
doc/source/contributor/index.rst View File

@ -0,0 +1,8 @@
============================
Tricircle Contribution Guide
============================
.. toctree::
:maxdepth: 1
contributing

+ 33
- 15
doc/source/index.rst View File

@ -7,26 +7,44 @@
Welcome to Tricircle's documentation!
=====================================
Contents
========
Tricircle User Guide
====================
.. toctree::
:maxdepth: 3
user/index
Tricircle Contribution Guide
============================
.. toctree::
:maxdepth: 2
contributor/index
Tricircle Admin Guide
=====================
.. toctree::
:maxdepth: 3
readme
usage
installation-guide
configuration
networking-guide
vlan-aware-vms-guide
service-function-chaining-guide
api_v1
contributing
admin/index
Tricircle Installation Guide
============================
.. toctree::
:maxdepth: 3
install/index
Tricircle Configuration Guide
=============================
.. toctree::
:maxdepth: 3
configuration/index
Indices and tables
==================
Tricircle Networking Guide
==========================
.. toctree::
:maxdepth: 4
* :ref:`genindex`
* :ref:`search`
networking/index

+ 8
- 0
doc/source/install/index.rst View File

@ -0,0 +1,8 @@
============================
Tricircle Installation Guide
============================
.. toctree::
:maxdepth: 3
installation-guide

doc/source/installation-cell.rst → doc/source/install/installation-cell.rst View File


doc/source/installation-guide.rst → doc/source/install/installation-guide.rst View File


doc/source/installation-manual.rst → doc/source/install/installation-manual.rst View File


doc/source/multi-pod-installation-devstack.rst → doc/source/install/multi-pod-installation-devstack.rst View File


doc/source/single-pod-installation-devstack.rst → doc/source/install/single-pod-installation-devstack.rst View File


+ 8
- 0
doc/source/networking/index.rst View File

@ -0,0 +1,8 @@
==========================
Tricircle Networking Guide
==========================
.. toctree::
:maxdepth: 4
networking-guide

doc/source/networking-guide-direct-provider-networks.rst → doc/source/networking/networking-guide-direct-provider-networks.rst View File


doc/source/networking-guide-local-networking.rst → doc/source/networking/networking-guide-local-networking.rst View File


doc/source/networking-guide-multiple-external-networks.rst → doc/source/networking/networking-guide-multiple-external-networks.rst View File


doc/source/networking-guide-multiple-ns-with-ew-enabled.rst → doc/source/networking/networking-guide-multiple-ns-with-ew-enabled.rst View File


doc/source/networking-guide-single-external-network.rst → doc/source/networking/networking-guide-single-external-network.rst View File


doc/source/networking-guide.rst → doc/source/networking/networking-guide.rst View File


doc/source/networking-prerequisites.rst → doc/source/networking/networking-prerequisites.rst View File


doc/source/networking-scenarios.rst → doc/source/networking/networking-scenarios.rst View File


doc/source/networking-terms.rst → doc/source/networking/networking-terms.rst View File


doc/source/service-function-chaining-guide.rst → doc/source/networking/service-function-chaining-guide.rst View File


doc/source/vlan-aware-vms-guide.rst → doc/source/networking/vlan-aware-vms-guide.rst View File


+ 0
- 1
doc/source/readme.rst View File

@ -1 +0,0 @@
.. include:: ../../README.rst

+ 9
- 0
doc/source/user/index.rst View File

@ -0,0 +1,9 @@
====================
Tricircle User Guide
====================
.. toctree::
:maxdepth: 3
readme
usage

+ 2
- 0
doc/source/user/readme.rst View File

@ -0,0 +1,2 @@
.. include:: ../../../README.rst
:start-line: 10

doc/source/usage.rst → doc/source/user/usage.rst View File


+ 44
- 0
index.rst View File

@ -0,0 +1,44 @@
.. tricircle documentation master file, created by
sphinx-quickstart on Wed Dec 2 17:00:36 2015.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
=====================================
Welcome to Tricircle's documentation!
=====================================
User Documentation
==================
.. toctree::
:maxdepth: 3
user/index
Contributor Guide
=================
.. toctree::
:maxdepth: 1
contributor/index
Admin Guide
===========
.. toctree::
:maxdepth: 3
admin/index
Installation Guide
==================
.. toctree::
:maxdepth: 3
install/index
Configuration Guide
===================
.. toctree::
:maxdepth: 3
configuration/index

Loading…
Cancel
Save