summaryrefslogtreecommitdiffstats
path: root/docs/opnfvsecguide/contribution.rst
diff options
context:
space:
mode:
authorLuke Hinds <luke.hinds@nokia.com>2015-11-10 18:57:43 +0000
committerLuke Hinds <luke.hinds@nokia.com>2015-11-10 19:02:04 +0000
commit18140941aa30ef189615367185c63cc761d74bbb (patch)
tree9b0022fbb47dcaf75f0abdfbce33b2f2fe72678f /docs/opnfvsecguide/contribution.rst
parent256683072fb4c5b0bba36ddfd273b9bab0213945 (diff)
Added opnfv-security-guide
Modified conf.py to include RTD theme.... html_theme = 'sphinx_rtd_theme' Change-Id: I9b004725ba4ca6606ad8b9e8700f4395ccdeafaa Signed-off-by: Luke Hinds <luke.hinds@nokia.com>
Diffstat (limited to 'docs/opnfvsecguide/contribution.rst')
-rw-r--r--docs/opnfvsecguide/contribution.rst41
1 files changed, 41 insertions, 0 deletions
diff --git a/docs/opnfvsecguide/contribution.rst b/docs/opnfvsecguide/contribution.rst
new file mode 100644
index 000000000..954c5785e
--- /dev/null
+++ b/docs/opnfvsecguide/contribution.rst
@@ -0,0 +1,41 @@
+How to Contribute
+-----------------
+
+Anyone is welcome to make additions, raise bugs, and fix issues within this Documentation. To do so, you will however need to first get an enviroment set up.
+
+Development Environment
+#######################
+
+All project data such as formatting guidelines, and upstream mapping is documented via sphinx which uses reStructuredText
+
+It is recommended that you use a python virtualenv to keep things clean and contained.
+
+VirtualEnv
+**********
+
+Use of a virtual environment is recommended, as not only is it a quick easy form of getting the needed modules in place, it isolates the module versions to a project.
+
+From within your inspector directory, set up a new virtualenv::
+
+ virtualenv venv
+
+Activate the new virtual environment::
+
+ source venv/bin/activate
+
+Install requirements::
+
+ pip install -r requirements.txt
+
+Sphinx Basics
+*************
+
+To get started with sphinx, visit the main tutorial which will provide a primer `http://sphinx-doc.org/tutorial.html`
+
+Hack your changes into opnfv-security-guide/source
+
+To compile changes:
+
+ make html
+
+From here you can run a basic python web server or just navigate to the file:///<repo>/opnfv-security-guide/build/html/index.html in your browser \ No newline at end of file