summaryrefslogtreecommitdiffstats
path: root/docs/guides/onap-documentation
diff options
context:
space:
mode:
authorthmsdt <thomas.kulik@telekom.de>2021-10-05 14:26:33 +0200
committerthmsdt <thomas.kulik@telekom.de>2021-10-05 15:59:35 +0200
commitf7bea33fd4703cf129794cae0b951d818e209ed4 (patch)
tree58829ce00b71dc10a918fe76e1bf68d5139e6a45 /docs/guides/onap-documentation
parentc41a9942b921f0603e6f9e03b43da3fbbdc2e264 (diff)
Update "Setup of a Documentation Development System"
Issue-ID: DOC-746 Signed-off-by: thmsdt <thomas.kulik@telekom.de> Change-Id: Ib9f03a94906dd9e6984226dc28b1a98a458ae8cb
Diffstat (limited to 'docs/guides/onap-documentation')
-rw-r--r--docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst33
1 files changed, 18 insertions, 15 deletions
diff --git a/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst b/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst
index 2c7d0a3dc..b8b4a452a 100644
--- a/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst
+++ b/docs/guides/onap-documentation/setup-of-a-doc-dev-system.rst
@@ -39,10 +39,10 @@ Setup of a Documentation Development System
#########################################################################
Release Relevance
- 8.0.0 (Honolulu) - 1.0.0 (Amsterdam)
+ 9.0.0 (Istanbul) - 6.0.0 (Frankfurt)
Last Review/Update
- 06/17/2021
+ 10/05/2021
Initial Release
05/12/2021
@@ -74,6 +74,10 @@ project and can be found in the ``docs`` directory. The files are automatically
processed and you find the final ONAP documentation build hosted on
`ReadTheDocs <https://docs.onap.org>`__.
+Beginning with the 'Frankfurt' release of ONAP, the documentation structure has
+changed and the support of submodules was removed. Although large parts of this
+guide are valid for earlier releases, the relevance has been limited.
+
-------------------------------------------------------------------------------
VM Configuration
@@ -85,9 +89,9 @@ VM Configuration
Ubuntu Image
------------
-+----------------------------------------+
-| ubuntu-20.04.2.0-desktop-amd64.iso |
-+----------------------------------------+
++--------------------------------------+
+| ubuntu-20.04.3-desktop-amd64.iso |
++--------------------------------------+
Please check what image must be used for your type of hardware.
@@ -288,18 +292,13 @@ your terminal has changed. Now it starts with ``(onapdocs)``.
.. code-block:: bash
pip3 install wheel
- pip3 install sphinx_rtd_theme
- pip3 install sphinxcontrib-blockdiag
- pip3 install sphinxcontrib-needs
- pip3 install sphinxcontrib-nwdiag
- pip3 install sphinxcontrib-seqdiag
- pip3 install sphinxcontrib-swaggerdoc
- pip3 install sphinxcontrib-plantuml
pip3 install lfdocs-conf
- pip3 install pylint
which sphinx-build
+.. note:: The ``lfdocs-conf`` package requires multiple, additional libraries.
+ They are loaded automatically.
+
.. tip:: Remember the path
``/home/<USER>/environments/onapdocs/bin/sphinx-build``, you need it later
to configure a VSC extension.
@@ -314,8 +313,8 @@ desktop search function :guilabel:`Show Applications` (the |ShowApp| symbol in
the bottom left corner) to find the required applications.
Open :guilabel:`Ubuntu Software` > :guilabel:`Development`, select
-:guilabel:`Visual Studio Code` and press :guilabel:`Install` to install the
-integrated development environment (IDE).
+:guilabel:`code` (Visual Studio Code) and press :guilabel:`Install` to install
+the integrated development environment (IDE).
Open :guilabel:`Ubuntu Software` > :guilabel:`Updates` to ensure that your
installed applications are up to date.
@@ -387,6 +386,8 @@ Start VSC (always) in the ``docs`` directory of your repository. For the
cd docs
code .
+.. important:: Don't forget the ``.`` (dot) when you start Visual Studio Code.
+
.. tip:: ``~/environments/onapdocs/doc/docs`` is now your
``${workspaceFolder}`` because you have started VSC (``code .``) from here!
@@ -464,6 +465,8 @@ Only in case the preview creates an error message, try ...
Close the :guilabel:`Extension Settings` window.
+Close VSC and start it again with the ``code .`` command.
+
-------------------------------------------------------------------------------
Open a .rst file and preview it in VSC