From 3f854f15247c82e5ee4ae19ef72130ef1008e53d Mon Sep 17 00:00:00 2001 From: ShubhamRathi Date: Thu, 26 Jan 2017 18:35:38 +0530 Subject: [PATCH] New docs for 'How to include documentation' This documentation elucidates the revised procedure to include project documentation. Change-Id: Icfcab3a07e386453ae7faf9fa737fe726ff70f0c Signed-off-by: ShubhamRathi --- docs/how-to-use-docs/Submodules.jpg | Bin 0 -> 85389 bytes docs/how-to-use-docs/include-documentation.rst | 135 ++++++++++++++++++------- 2 files changed, 98 insertions(+), 37 deletions(-) create mode 100644 docs/how-to-use-docs/Submodules.jpg diff --git a/docs/how-to-use-docs/Submodules.jpg b/docs/how-to-use-docs/Submodules.jpg new file mode 100644 index 0000000000000000000000000000000000000000..aeb7956a31d5588c67286cdb774155b1359e5239 GIT binary patch literal 85389 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/docs/ directory in your repository. +For instance if you want to document userguide, then your steps shall be +as follows: .. code-block:: bash - mkdir /docs/userguide + git clone ssh://@gerrit.opnfv.org:29418/opnfvdocs.git - cp opnfvdocs/docs/userguide/userguide.rst /docs/userguide + cp -p opnfvdocs/docs/userguide/* /docs/userguide/ -You should then add the relevant information to the template that will explain the usage of your feature and instructions for validating that the feature was used successfully like checking the results of specific test cases. Be sure to maintain the creative commons license from the template and ensure all your documentation files include the license information. +You should then add the relevant information to the template that will +explain the documentation. When you are done writing, you can commit +the documentation to the project repository. + +.. code-block:: bash + + git add . + git commit --signoff --all + git review -Once your documentation is ready you should ensure they are compiled into the staging files by adding them to the master

.rst file in the opnfvdocs repository. The staging files are structured in such a way that you should refer to your document in the correct section of the document structure. +In OPNFVDocs Composite Documentation +-------------------------------------- + +In toctree ++++++++++++ + +To import project documents from project repositories, we use submodules. + Each project is stored in :code:`opnfvdocs/docs/submodule/` as follows: + +.. image:: Submodules.jpg + :scale: 50 % + +To include your project specific documentation in the composite documentation, +first identify where your project documentation should be included. +Say your project userguide should figure in the ‘OPNFV Userguide’, then: -An example of how to add your documentation to the relevant sections of the feature-usage.rst file might be: .. code-block:: bash - git clone ssh://@gerrit.opnfv.org:29418/opnfvdocs.git - cd opnfvdocs - git review -s - vim docs/userguide/feature-usage.rst ' + vim opnfvdocs/docs/release/userguide.introduction.rst + +This opens the text editor. Identify where you want to add the userguide. +If the userguide is to be added to the toctree, simply include the path to +it, example: -At this point you should add the references to your files into the index.rst file, for instance in the feature description section you would add the line: -The following sections of the user guide provide feature specific usage guidelines and references. -Providing users the necessary information to leveraging the features in the platform, -some operation in this section may refer back to the guides in the general system usage section. .. code-block:: bash -.. include:: ../projects/promise/userguide/userguide.rst -.. include:: ../projects/copper/userguide/userguide.rst Using Brahmaputra Features -.. include:: ../projects//userguide/userguide.rst'' + .. toctree:: + :maxdepth: 1 + + submodules/functest/docs/userguide/index + submodules/bottlenecks/docs/userguide/index + submodules/yardstick/docs/userguide/index + + +As Hyperlink ++++++++++++++ + +It's pretty common to want to reference another location in the +OPNFV documentation and it's pretty easy to do with +reStructuredText. This is a quick primer, more information is in the +`Sphinx section on Cross-referencing arbitrary locations +`_. + +Within a single document, you can reference another section simply by:: + + This is a reference to `The title of a section`_ + +Assuming that somewhere else in the same file there a is a section +title something like:: + + The title of a section + ^^^^^^^^^^^^^^^^^^^^^^ + +It's typically better to use ``:ref:`` syntax and labels to provide +links as they work across files and are resilient to sections being +renamed. First, you need to create a label something like:: + + .. _a-label: + + The title of a section + ^^^^^^^^^^^^^^^^^^^^^^ + +.. note:: The underscore (_) before the label is required. + +Then you can reference the section anywhere by simply doing:: -If this is the first contribution from your project to the composite document files you will need to add your project to the build-composite.sh file in the opnfvdocs directory. This is done my editing the jsdgf file and adding your repository name to the get_repo_names() function of the script. Assuming you are still in the opnfvdocs directory edit the file with the following command: -' vim build-composite.sh ' + This is a reference to :ref:`a-label` +or:: -Once you have the file open, add your projects repository to the get_repo_names() function: + This is a reference to :ref:`a section I really liked ` -.. code-block:: python - get_repo_names() { - # NOTE: Not all repositories are ready for the composite docs, - # so we have the repo name list here to add project docs - # one by one. This will be replaced by the list in project.cfg . - # grep -v '^#' releng/jjb/opnfvdocs/project.cfg | sort - echo "sdnvpn" - echo "" +.. note:: When using ``:ref:``-style links, you don't need a trailing + underscore (_). +Because the labels have to be unique, it usually makes sense to prefix +the labels with the project name to help share the label space, e.g., +``sfc-user-guide`` instead of just ``user-guide``. -Once you have made these changes you need to push the patch back to the opnfvdocs team for review and integration. +Once you have made these changes you need to push the patch back to +the opnfvdocs team for review and integration. .. code-block:: bash - ' git add . ' - ' git commit --signoff --all ' - ' git review ' - + git add . + git commit --signoff --all + git review -Be sure to add the project leader of the opnfvdocs project as a reviewer of the change you just pushed in gerrit. Also be aware that once the text is available in the context of the broader release document it may require some revising and editorial work to prepare it for release. +Be sure to add the project leader of the opnfvdocs project +as a reviewer of the change you just pushed in gerrit. -- 2.16.6