summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEd Kern <ejk@cisco.com>2018-07-11 07:45:41 -0600
committerDave Barach <openvpp@barachs.net>2018-07-11 18:10:04 +0000
commitbf2f3261b2302e2cc182ea71b7df61c2e2b405ce (patch)
tree56449c949f363e7911c8f47e947e2049584e565c
parent067cd6229a47ea3ba8b59a2a04090e80afb5bd2c (diff)
Documentation: Placeholder directory and files
This adds the directory sphinx and sphinx/docs as well as two matching placeholder files. These are being added now to facilitate some gerrit triggers Change-Id: I0e6e7607c5ae5cdbf05718b95b1d299178544485 Signed-off-by: Ed Kern <ejk@cisco.com>
-rw-r--r--docs/README.rst56
1 files changed, 56 insertions, 0 deletions
diff --git a/docs/README.rst b/docs/README.rst
new file mode 100644
index 00000000000..809bddb6e63
--- /dev/null
+++ b/docs/README.rst
@@ -0,0 +1,56 @@
+
+Overview
+========
+
+This repository was created as a private staring point for the vpp documentation
+project. It is expected that it will be used as a sandbox that can be used to
+evaluate and comment on the new fd.io document structure.
+
+Build and Load Instructions
+===========================
+I build and load the documents using a mac, but these instuctions should be portable
+to any platform. I used the Python virtual environment.
+
+For more information on how to use the Python virtual enviroment check out
+`Installing packages using pip and virtualenv`_.
+
+.. _`Installing packages using pip and virtualenv`: https://packaging.python.org/guides/installing-using-pip-and-virtualenv/
+
+1. Get the repository
+
+.. code-block:: console
+
+ git clone https://github.com/fdioDocs/vpp-docs
+ cd vpp-docs
+
+2. Install the virtual environment
+
+.. code-block:: console
+
+ python -m pip install --user virtualenv
+ python -m virtualenv env
+ source env/bin/activate
+ pip install -r etc/requirements.txt
+
+.. note::
+
+ To exit from the virtual environment execute:
+
+.. code-block:: console
+
+ deactivate
+
+3. Build the html files
+
+.. code-block:: console
+
+ cd docs
+ make html
+
+4. View the results.
+
+To view the results start a browser and open the file:
+
+.. code-block:: console
+
+ <THE CLONED DIRECTORY>/docs/_build/html/index.html