X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fguides%2Fonap-developer%2Fhow-to-use-docs%2Ftemplates%2Fsections%2Fconfiguration.rst;h=6d1ec29baba632833776e59d565da4d3f1d7e6c9;hb=32d2daf4c1c9a01c6cc6e9b4218b9f4d2650b8e8;hp=085f9c667d06c375fe0c7f48c9843788bcb5302e;hpb=c7d15886be96f3036709bb0acc4beb7169e8eec1;p=doc.git diff --git a/docs/guides/onap-developer/how-to-use-docs/templates/sections/configuration.rst b/docs/guides/onap-developer/how-to-use-docs/templates/sections/configuration.rst index 085f9c667..6d1ec29ba 100644 --- a/docs/guides/onap-developer/how-to-use-docs/templates/sections/configuration.rst +++ b/docs/guides/onap-developer/how-to-use-docs/templates/sections/configuration.rst @@ -4,24 +4,59 @@ Configuration ============= -.. note:: - * This section is used to describe the options a software component offers for configuration. +.. + * This section is used to describe the options a software component offers + for configuration. * Configuration is typically: provided for platform-component and sdk projects; and referenced in developer and user guides. - - * This note must be removed after content has been added. +Pre-requisites +-------------- -Example ... +.. + List here any dependencies and pre-requisites, e.g. component has to be + deployed, necessary connections have been established, etc. -You can provide the following in ``basic.conf`` -``host=ADDRESS`` - The address of the host +Editing the configuration file +------------------------------ -``port=PORT`` - The port used for signaling +.. + Describe the parameters and their values included in the config file. - Optional. Default: ``8080`` + +Configuration steps +------------------- + +.. + Add the necessary steps to configure the component, including all options/ + alternatives. + Provide examples (screenshots for GUI, commands for CLI) wherever possible. + +#. Add the configuration. + +Example command: + +.. code-block:: bash + + example command + +Example screenshot: + +.. figure:: https://www.onap.org/wp-content/uploads/sites/20/2017/02/logo_onap_2017.png + :alt: Example image + :width: 50 % + +#. Validate the configuration. + +.. code-block:: bash + + example command to validate the configuration + +Output for successful execution: + +.. code-block:: bash + + Example output