[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

doc/source/admin/cli.rst

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

doc/source/admin/index.rst

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

doc/source/configuration/index.rst

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

doc/source/contributing.rst

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

doc/source/contributor/contributing.rst

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

doc/source/contributor/index.rst

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

doc/source/index.rst

@@ -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

doc/source/install/index.rst

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

doc/source/networking/index.rst

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

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

@@ -10,3 +10,5 @@ typical networking mode will be described.
 .. include:: ./networking-terms.rst
 .. include:: ./networking-prerequisites.rst
 .. include:: ./networking-scenarios.rst
+.. include:: ./service-function-chaining-guide.rst
+.. include:: ./vlan-aware-vms-guide.rst

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

@@ -3,7 +3,7 @@ Networking Scenario
 ===================
 
 .. toctree::
-    :maxdepth: 3
+    :maxdepth: 4
 
     networking-guide-direct-provider-networks.rst
     networking-guide-multiple-external-networks.rst

doc/source/readme.rst

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

doc/source/user/index.rst

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

doc/source/user/readme.rst

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

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

@@ -1,6 +1,6 @@
-======
+=====
 Usage
-======
+=====
 
 To use tricircle in a project::
 

index.rst

@@ -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
+