From e35874cae19351f76d4b11878784b16db80a0e16 Mon Sep 17 00:00:00 2001
From: "David B. Kinder" <david.b.kinder@intel.com>
Date: Thu, 26 Apr 2018 09:00:14 -0700
Subject: [PATCH] doc: introduce howto area for technical notes

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 <david.b.kinder@intel.com>
---
 doc/conf.py                                   |   2 +-
 doc/howtos/index.rst                          |  27 ++++++++++++++++++
 .../process}/acrn-doc-fork.png                | Bin
 doc/{ => howtos/process}/docbuild.rst         |   2 +-
 doc/howtos/tech/placeholder.rst               |   6 ++++
 doc/index.rst                                 |   2 +-
 6 files changed, 36 insertions(+), 3 deletions(-)
 create mode 100644 doc/howtos/index.rst
 rename doc/{images => howtos/process}/acrn-doc-fork.png (100%)
 rename doc/{ => howtos/process}/docbuild.rst (99%)
 create mode 100644 doc/howtos/tech/placeholder.rst

diff --git a/doc/conf.py b/doc/conf.py
index f6c1ab5ec..d6974300f 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -161,7 +161,7 @@ else:
 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
new file mode 100644
index 000000000..8f3bedc53
--- /dev/null
+++ 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/images/acrn-doc-fork.png b/doc/howtos/process/acrn-doc-fork.png
similarity index 100%
rename from doc/images/acrn-doc-fork.png
rename to doc/howtos/process/acrn-doc-fork.png
diff --git a/doc/docbuild.rst b/doc/howtos/process/docbuild.rst
similarity index 99%
rename from doc/docbuild.rst
rename to doc/howtos/process/docbuild.rst
index 0ec23aebc..adf0ebf67 100644
--- a/doc/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
new file mode 100644
index 000000000..0f3551e15
--- /dev/null
+++ 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
index 6588f2c93..6d81e90b7 100644
--- 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
 ******************