doc: introduce howto area for technical notes

dbkinder · jren1 · commit e35874cae193 · 2018-05-15T17:25:57.000+08:00
Tech note articles about technology and process tips now have a place in
the ACRN documentaion.

Move the doc process documention into this new area, and add a
placeholder for tech tips for now.

Signed-off-by: David B. Kinder &lt;david.b.kinder@intel.com&gt;
diff --git a/doc/conf.py b/doc/conf.py
@@ -161,7 +161,7 @@
 html_context = {
    'current_version': current_version,
    'versions': ( ("latest", "/latest/"),
-                 ("0.1-rc4", "/0.1-rc4/"),
+#                 ("0.1-rc4", "/0.1-rc4/"),
                )
     }
 
diff --git a/doc/howtos/index.rst b/doc/howtos/index.rst
@@ -0,0 +1,27 @@
+.. _howtos:
+
+How-Tos
+#######
+
+Our technical documentation for Project ACRN is being developed right
+along with the features.  Here are some how-to technical notes that help
+explain how you can use ACRN capabilities.
+
+
+Technical Notes
+===============
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   tech/*
+
+Process Notes
+=============
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   process/*
diff --git a/doc/howtos/process/acrn-doc-fork.png b/doc/howtos/process/acrn-doc-fork.png
diff --git a/doc/howtos/process/docbuild.rst b/doc/howtos/process/docbuild.rst
@@ -73,7 +73,7 @@ upstream project ACRN repos (though https clones work too):
    time, visit the **acrn-documentation**, **acrn-hypervisor**, and
    **acrn-devicemodel** repos and do a fork to your personal GitHub account.
 
-   .. image:: images/acrn-doc-fork.png
+   .. image:: acrn-doc-fork.png
       :align: center
 
 #. At a command prompt, create the working folder and clone the three
diff --git a/doc/howtos/tech/placeholder.rst b/doc/howtos/tech/placeholder.rst
@@ -0,0 +1,6 @@
+.. _wip:
+
+Work in Progress
+################
+
+This is a placeholder doc for technical how-to articles in-progress.
diff --git a/doc/index.rst b/doc/index.rst
@@ -28,10 +28,10 @@ Sections
    hardware.rst
    getting_started/index.rst
    primer/index.rst
+   howtos/index.rst
    release_notes.rst
    contribute.rst
    api/index.rst
-   docbuild.rst
 
 Indices and Tables
 ******************

Original file line number	Diff line number	Diff line change
`@@ -161,7 +161,7 @@`
`161`	`161`	`html_context = {`
`162`	`162`	`'current_version': current_version,`
`163`	`163`	`'versions': ( ("latest", "/latest/"),`
`164`		`- ("0.1-rc4", "/0.1-rc4/"),`
	`164`	`+# ("0.1-rc4", "/0.1-rc4/"),`
`165`	`165`	`)`
`166`	`166`	`}`
`167`	`167`