diff options
author | Luca Muscariello <muscariello@ieee.org> | 2020-02-13 21:31:20 +0100 |
---|---|---|
committer | Mauro Sardara <msardara@cisco.com> | 2020-02-13 20:39:34 +0000 |
commit | 7ecd7bf20999042a13e88c2ac3c8b851d1db8da4 (patch) | |
tree | 848a7f3a2ba716af8fc97a6d00e23e2cb2d2e5ca /docs/README.md | |
parent | 3bce9bfdce707313de4f9cccdc867abd9edf82df (diff) |
[HICN-519] Documentation update
Change-Id: Iba61bc07196643b8061f0cb0f7213c7e0b256020
Signed-off-by: Luca Muscariello <muscariello@ieee.org>
Diffstat (limited to 'docs/README.md')
-rw-r--r-- | docs/README.md | 23 |
1 files changed, 9 insertions, 14 deletions
diff --git a/docs/README.md b/docs/README.md index c99cf879b..d7a6c6cc8 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,27 +1,24 @@ -Building Documents +# Building Documents These instructions show how documentation sources are built. To build your files, you can either Create a Virtual Environment using virtualenv, which installs all the required applications for you. -Create a Virtual Environment using virtualenv -============================ +# Create a Virtual Environment using virtualenv For more information on how to use the Python virtual environment check -out https://packaging.python.org/guides/installing-using-pip-and-virtualenv +out <https://packaging.python.org/guides/installing-using-pip-and-virtualenv> -Get the Documents ------------------------------- +# Get the Documents -For example start with a clone of the vpp. +For example start with a clone of the hicn. -$ git clone https://gerrit.fd.io/r/hicn +$ git clone <https://gerrit.fd.io/r/hicn> $ cd hicn -Install the virtual environment ----------------------------------------------- +# Install the virtual environment $ python3 -m pip install --user virtualenv $ python3 -m virtualenv env @@ -33,16 +30,14 @@ Which installs all the required applications into it's own, isolated, virtual environment, so as to not interfere with other builds that may use different versions of software. -Build the html files ----------------------------- +# Build the html files Be sure you are in your hicn/docs directory, since that is where Sphinx will look for your conf.py file, and build the documents into an index.html file $ make html -View the results ------------------------- +# View the results If there are no errors during the build process, you should now have an index.html file in your hicn/docs/build/html directory, which you can |