From ac0407ab8f7138e537b8be8d2d40c4e81f30c38c Mon Sep 17 00:00:00 2001 From: thmsdt Date: Mon, 14 Mar 2022 20:16:46 +0100 Subject: Update guide for setting up the doc dev environment Issue-ID: DOC-782 Signed-off-by: thmsdt Change-Id: I891d494f6fb1dcf0f8e425a0206d41a16b4dc066 --- .../setup-of-a-doc-dev-system.rst | 38 ++++++++++++++-------- 1 file changed, 25 insertions(+), 13 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 3352d133f..5d4fc59d6 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 - 9.0.0 (Istanbul) - 6.0.0 (Frankfurt) + 10.0.0 (Jakarta) - 6.0.0 (Frankfurt) Last Review/Update - 10/05/2021 + 14/03/2022 Initial Release 05/12/2021 @@ -397,6 +397,10 @@ Disable Telemetry of VSC ======================== In case you want to disable telemetry functionality of Visual Studio Code, open +:guilabel:`File` > :guilabel:`Preferences` > :guilabel:`Telemetry Settings` and +turn it ``off`` in the selection field. + +In an older version of VSC you alternatively need to open :guilabel:`File` > :guilabel:`Preferences` > :guilabel:`Settings` and search for ``telemetry``. Then uncheck :guilabel:`Telemetry: Enable Crash Reporter` and @@ -424,17 +428,23 @@ Press :guilabel:`Install` if you have found the required extension. Please install ... -+-----------------------+-----------------------------------------+ -| Python | ms-python.python | -+-----------------------+-----------------------------------------+ -| reStructuredText | lextudio.restructuredtext | -+-----------------------+-----------------------------------------+ -| Code Spell Checker | streetsidesoftware.code-spell-checker | -+-----------------------+-----------------------------------------+ -| Prettier | esbenp.prettier-vscode | -+-----------------------+-----------------------------------------+ -| GitLens | eamodio.gitlens | -+-----------------------+-----------------------------------------+ ++--------------------------------------+---------------------------------------+---------+ +| Python | ms-python.python | latest | ++--------------------------------------+---------------------------------------+---------+ +| reStructuredText | lextudio.restructuredtext | 169.0.0 | ++--------------------------------------+---------------------------------------+---------+ +| reStructuredText Syntax highlighting | trond-snekvik.simple-rst | latest | ++--------------------------------------+---------------------------------------+---------+ +| Code Spell Checker | streetsidesoftware.code-spell-checker | latest | ++--------------------------------------+---------------------------------------+---------+ +| Prettier | esbenp.prettier-vscode | latest | ++--------------------------------------+---------------------------------------+---------+ +| GitLens | eamodio.gitlens | latest | ++--------------------------------------+---------------------------------------+---------+ + +.. note:: Use the reStructuredText extension version 169.0.0 or lower to + avoid problems with the preview. You need to downgrade after the initial + installation. Configure reStructuredText extension ------------------------------------ @@ -659,6 +669,7 @@ Visual Studio Code (VSC) - `VSC Basic Editing `__ - `Code Formatting with Prettier in Visual Studio Code `__ - `VSC Icons `__ +- `reStructuredText Extension `__ ------------------------------------------------------------------------------- @@ -688,6 +699,7 @@ for one of the upcoming releases. - evaluate ``snooty`` and describe functionality (build in? not a extension?) - add a table explaining the role of installed packages/extensions in every section + - update instructions to enable use of latest reStructuredText VSC extension .. ######################################################################### -- cgit 1.2.3-korg