16 files changed, 103 insertions, 14 deletions
diff --git a/docs/configguide/feature-config.rst b/docs/configguide/feature-config.rst
index 992f501b6..96409b85c 100644
--- a/docs/configguide/feature-config.rst
+++ b/docs/configguide/feature-config.rst
@@ -9,9 +9,22 @@ Feature Configuration
 The following sections describe the configuration options for specific platform features provided in Brahmaputra.
 Further details for each feature are captured in the referred project documentation.
 
-.. include:: ../projects/copper/configguide/configguide.rst
-.. include:: ../projects/doctor/configguide/configguide.rst
-.. include:: ../projects/ipv6/configguide/featureconfig.rst
-.. include:: ../projects/promise/configguide/featureconfig.rst
-.. include:: ../projects/sdnvpn/configguide/configguide.rst
+.. toctree::
 
+    featureconfig-copper
+
+.. toctree::
+
+    featureconfig-doctor
+
+.. toctree::
+
+    featureconfig-ipv6
+
+.. toctree::
+
+    featureconfig-promise
+
+.. toctree::
+
+    featureconfig-sdnvpn
diff --git a/docs/configguide/featureconfig-copper.rst b/docs/configguide/featureconfig-copper.rst
new file mode 100644
index 000000000..5a348deaa
--- /dev/null
+++ b/docs/configguide/featureconfig-copper.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/copper/configguide/featureconfig.rst
diff --git a/docs/configguide/featureconfig-doctor.rst b/docs/configguide/featureconfig-doctor.rst
new file mode 100644
index 000000000..ef9906457
--- /dev/null
+++ b/docs/configguide/featureconfig-doctor.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/doctor/configguide/configguide.rst
diff --git a/docs/configguide/featureconfig-ipv6.rst b/docs/configguide/featureconfig-ipv6.rst
new file mode 100644
index 000000000..49211f517
--- /dev/null
+++ b/docs/configguide/featureconfig-ipv6.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/ipv6/configguide/featureconfig.rst
diff --git a/docs/configguide/featureconfig-promise.rst b/docs/configguide/featureconfig-promise.rst
new file mode 100644
index 000000000..bd1d7f5d3
--- /dev/null
+++ b/docs/configguide/featureconfig-promise.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/promise/configguide/featureconfig.rst
diff --git a/docs/configguide/featureconfig-sdnvpn.rst b/docs/configguide/featureconfig-sdnvpn.rst
new file mode 100644
index 000000000..dc4d2d970
--- /dev/null
+++ b/docs/configguide/featureconfig-sdnvpn.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/sdnvpn/configguide/configguide.rst
diff --git a/docs/configguide/installer-config.rst b/docs/configguide/installer-config.rst
index 7d84f9e1d..ad10cb4ae 100644
--- a/docs/configguide/installer-config.rst
+++ b/docs/configguide/installer-config.rst
@@ -9,8 +9,14 @@ Installer Configuration
 The following sections describe the per installer configuration options.
 Further details for each installer are captured in the referred project documentation.
 
-.. include:: ../projects/apex/configguide/introduction.rst
-.. include:: ../projects/apex/configguide/baremetalinstall.rst
-.. include:: ../projects/fuel/configguide/installerconfig.rst
-.. include:: ../projects/joid/configguide/installerconfig.rst
+.. toctree::
 
+    installerconfig-apex
+
+.. toctree::
+
+    installerconfig-fuel
+
+.. toctree::
+
+    installerconfig-joid
diff --git a/docs/configguide/installerconfig-apex.rst b/docs/configguide/installerconfig-apex.rst
new file mode 100644
index 000000000..272956540
--- /dev/null
+++ b/docs/configguide/installerconfig-apex.rst
@@ -0,0 +1,11 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. NOTE: this is workaround and has to be fixed in each project repo.
+
+==================
+Apex configuration
+==================
+
+.. include:: ../projects/apex/configguide/introduction.rst
+.. include:: ../projects/apex/configguide/baremetalinstall.rst
diff --git a/docs/configguide/installerconfig-fuel.rst b/docs/configguide/installerconfig-fuel.rst
new file mode 100644
index 000000000..2a66ea1b0
--- /dev/null
+++ b/docs/configguide/installerconfig-fuel.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/fuel/configguide/installerconfig.rst
diff --git a/docs/configguide/installerconfig-joid.rst b/docs/configguide/installerconfig-joid.rst
new file mode 100644
index 000000000..cd4e5e254
--- /dev/null
+++ b/docs/configguide/installerconfig-joid.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/joid/configguide/installerconfig.rst
diff --git a/docs/configguide/post-install.rst b/docs/configguide/post-install.rst
index 741905a52..0eca4ba08 100644
--- a/docs/configguide/post-install.rst
+++ b/docs/configguide/post-install.rst
@@ -15,8 +15,13 @@ Scenario validation activities
 The following guides provide information on how to validate the installation of you scenario
 based on the tools and test suites available for the installation tool you have selected:
 
-.. include:: ../projects/ipv6/configguide/postinstall.rst
-.. include:: ../projects/joid/configguide/postinstall.rst
+.. toctree::
+
+    postinstall-ipv6
+
+.. toctree::
+
+    postinstall-joid
 
 Feature validation activities
 =============================
@@ -24,7 +29,9 @@ Feature validation activities
 The following sections provide information on how to validate the features you have
 installed in your scenario:
 
-.. include:: ../projects/copper/configguide/postinstall.rst
+.. toctree::
+
+    postinstall-copper
 
 Additional testing and validation activities
 ============================================
@@ -33,6 +40,10 @@ Many of our testing tools can be manually installed to facilitate targeted testi
 of features and capabilities of your scenario.  The following guides provide instruction on
 setting up these testing suites:
 
-.. include:: ../projects/functest/configguide/configguide.rst
-.. include:: ../projects/vswitchperf/configguide/installation.rst
+.. toctree::
+
+    postinstall-functest
+
+.. toctree::
 
+    postinstall-vswitchperf
diff --git a/docs/configguide/postinstall-copper.rst b/docs/configguide/postinstall-copper.rst
new file mode 100644
index 000000000..06c4b151b
--- /dev/null
+++ b/docs/configguide/postinstall-copper.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/copper/configguide/postinstall.rst
diff --git a/docs/configguide/postinstall-functest.rst b/docs/configguide/postinstall-functest.rst
new file mode 100644
index 000000000..1bdced4c4
--- /dev/null
+++ b/docs/configguide/postinstall-functest.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/functest/configguide/configguide.rst
diff --git a/docs/configguide/postinstall-ipv6.rst b/docs/configguide/postinstall-ipv6.rst
new file mode 100644
index 000000000..8a51452b6
--- /dev/null
+++ b/docs/configguide/postinstall-ipv6.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/ipv6/configguide/postinstall.rst
diff --git a/docs/configguide/postinstall-joid.rst b/docs/configguide/postinstall-joid.rst
new file mode 100644
index 000000000..d986b6f22
--- /dev/null
+++ b/docs/configguide/postinstall-joid.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/joid/configguide/postinstall.rst
diff --git a/docs/configguide/postinstall-vswitchperf.rst b/docs/configguide/postinstall-vswitchperf.rst
new file mode 100644
index 000000000..e241d4978
--- /dev/null
+++ b/docs/configguide/postinstall-vswitchperf.rst
@@ -0,0 +1,4 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+
+.. include:: ../projects/vswitchperf/configguide/installation.rst