From 18140941aa30ef189615367185c63cc761d74bbb Mon Sep 17 00:00:00 2001 From: Luke Hinds Date: Tue, 10 Nov 2015 18:57:43 +0000 Subject: Added opnfv-security-guide Modified conf.py to include RTD theme.... html_theme = 'sphinx_rtd_theme' Change-Id: I9b004725ba4ca6606ad8b9e8700f4395ccdeafaa Signed-off-by: Luke Hinds --- docs/opnfvsecguide/contribution.rst | 41 +++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/opnfvsecguide/contribution.rst (limited to 'docs/opnfvsecguide/contribution.rst') 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:////opnfv-security-guide/build/html/index.html in your browser \ No newline at end of file -- cgit 1.2.3-korg