diff options
author | Sander Vrijders <[email protected]> | 2018-04-05 09:42:45 +0200 |
---|---|---|
committer | Sander Vrijders <[email protected]> | 2018-04-05 09:48:35 +0200 |
commit | 0b82eadc6e949f564bbb4835a2f8a0a25893e7dc (patch) | |
tree | 267217616fc216be6ee3403f75b6f2f6b1576161 | |
parent | ead056b9f91c3d9c6ee56adf5fd00ee5b0889db2 (diff) | |
download | rumba-0b82eadc6e949f564bbb4835a2f8a0a25893e7dc.tar.gz rumba-0b82eadc6e949f564bbb4835a2f8a0a25893e7dc.zip |
doc: Update docs with feedback from Miguel
This updates the docs with some feedback from Miguel. It should help
make the documentation easier to follow.
-rw-r--r-- | doc/conf.py | 2 | ||||
-rw-r--r-- | doc/installation.rst | 14 | ||||
-rw-r--r-- | doc/workflow.rst | 24 |
3 files changed, 27 insertions, 13 deletions
diff --git a/doc/conf.py b/doc/conf.py index 4ae4ea4..1a73e44 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -1,7 +1,7 @@ from datetime import datetime html_theme = "sphinx_rtd_theme" -extensions = [] +extensions = ['sphinx.ext.viewcode'] project = 'Rumba' year = datetime.now().year diff --git a/doc/installation.rst b/doc/installation.rst index c2038d0..1507cee 100644 --- a/doc/installation.rst +++ b/doc/installation.rst @@ -19,3 +19,17 @@ To install the latest version from source, clone the repository and install it from the command line: :: $ python setup.py install + +Generating the documentation +--------------------------------- + +To generate the documentation, run the following command in the root +folder of the repository: :: + + $ sphinx-build doc/ public/ + +This will generate HTML pages in the public/ folder. Other output +formats are possible by using a different 'builder', the following +command would for instance generate LaTeX files: :: + + $ sphinx-build -b latex doc/ latex/ diff --git a/doc/workflow.rst b/doc/workflow.rst index 95f68c2..d0e56a7 100644 --- a/doc/workflow.rst +++ b/doc/workflow.rst @@ -12,24 +12,24 @@ Workflow (Ouroboros, rlite, IRATI), passing the testbed instance and a list of Node instances. - 1. At the end of the base Experiment constructor, the - generate function is called to generate information about - per-node IPCPs, registrations and enrollment, ready to be - used by the prototype plugins. + * At the end of the base Experiment constructor, the + generate function is called to generate information about + per-node IPCPs, registrations and enrollment, ready to be + used by the prototype plugins. 4. Call methods on the prototype.Experiment instance: - 1. swap_in() swaps the experiment in on the testbed, and fills in - the missing information in the model. + * swap_in() swaps the experiment in on the testbed, and fills in + the missing information in the model. - 2. install_prototype() installs the chosen prototype on the testbed - (if necessary). Currently an Ubuntu image is assumed. + * install_prototype() installs the chosen prototype on the testbed + (if necessary). Currently an Ubuntu image is assumed. - 3. bootstrap_prototype() calls a prototype-specific setup function, - to create the required IPCPs, perform registrations, - enrollments, etc. + * bootstrap_prototype() calls a prototype-specific setup function, + to create the required IPCPs, perform registrations, + enrollments, etc. - 4. swap_out() swaps the experiment out of the testbed. + * swap_out() swaps the experiment out of the testbed. 5. Optionally run a Storyboard to emulate real network traffic. |