Merge "Documenting OPNFV GCE machins"
[opnfvdocs.git] / docs / how-to-use-docs / documentation-guide.rst
index fed42a4..0f2c3bf 100644 (file)
@@ -15,7 +15,7 @@ Getting Started with Documentation for Your Project
 OPNFV documentation is automated and integrated into our git & gerrit toolchains.
 
 We use RST document templates in our repositories and automatically render to HTML and PDF versions of the documents in our artifact
-store, our WiKi is also able to integrate these rendered documents directly allowing projects to use the revision controlled documentation
+store, our Wiki is also able to integrate these rendered documents directly allowing projects to use the revision controlled documentation
 process for project information, content and deliverables.
 Read :ref:`this page <include-documentation>` which elaborates on how documentation is to be included within opnfvdocs.
 
@@ -62,10 +62,14 @@ Following representation shows the expected structure:
         │   ├── scenarios
         │   │   └── scenario.name
         │   └── userguide
-        └── testing
-            ├── developer
-            └── user
-
+        ├── testing
+        │   ├── developer
+        │   └── user
+        └── infrastructure
+            ├── hardware-infrastructure
+            ├── software-infrastructure
+            ├── continuous-integration
+            └── cross-community-continuous-integration
 
 Release documentation
 ^^^^^^^^^^^^^^^^^^^^^
@@ -133,3 +137,8 @@ You are encouraged to establish the following basic structure for your project a
 **Project overview**: :code:`<repo>/docs/development/overview`
 
 - Folder for any project specific documentation.
+
+Infrastructure Documentation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Infrastructure documentation can be stored under :code:`<repo>/docs/` folder of
+corresponding infrastructure project.