diff options
| author |   Guillaume Lambert <guillaume.lambert@orange.com> | 2021-02-02 15:07:08 +0100 |
|---|---|---|
| committer | Guillaume Lambert <guillaume.lambert@orange.com> | 2021-02-02 15:58:38 +0100 |
| commit | 5b9d80a4e9175cfd6bd7f2be33c540053f726005 (patch) | |
| tree | 7d7601eeea1325ca655f1e481c3519f18be04671 /docs | |
| parent | 723363b3fed2e56d1229c4ea794e84d5f7c4f11c (diff) | |
[DOC] Fix tox docs-linkcheck profile issues
- ignore URLs logically unreachable such as about:config
- and create a code block for the git clone URL that is not reachable
- ignore URLs with anchors (especially the ones ill-generated
from external objects, mainly onap-integration)
- enforce tox docs-lincheck profile
Issue-ID: DOC-692
Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I619d8d5697a35bf2bdf3ee2ed59ca9f5733e7802
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/conf.py | 12 | ||||
| -rw-r--r-- | docs/guides/onap-user/vfw-design-tutorial/index.rst | 8 |
2 files changed, 18 insertions, 2 deletions
diff --git a/docs/conf.py b/docs/conf.py index 0c79cc989..33552e829 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -81,6 +81,18 @@ intersphinx_mapping['onap-vid'] = ('{}/onap-vid/en/%s'.format(doc_url) % branch, intersphinx_mapping['onap-aaf-authz'] = ('{}/onap-aaf-authz/en/%s'.format(doc_url) % branch, None) +linkcheck_ignore = [ + 'about:config', + # this URL is not directly reachable and must be configured in the system hosts file. + 'https://portal.api.simpledemo.onap.org:30225/ONAPPORTAL/login.htm', + # anchor issues + 'https://docs.onap.org/projects/onap-integration/en/latest/docs_usecases_release.html#.*', + 'https://docs.linuxfoundation.org/docs/communitybridge/easycla/contributors/contribute-to-a-gerrit-project#.*', + 'https://docs.onap.org/projects/onap-integration/en/latest/docs_robot.html#docs-robot', + 'https://docs.onap.org/projects/onap-integration/en/latest/docs_usecases_release.html#docs-usecases-release', + 'https://docs.onap.org/projects/onap-integration/en/latest/docs_usecases.html#docs-usecases', + 'https://docs.onap.org/projects/onap-integration/en/latest/usecases/release_non_functional_requirements.html#release-non-functional-requirements', +] diff --git a/docs/guides/onap-user/vfw-design-tutorial/index.rst b/docs/guides/onap-user/vfw-design-tutorial/index.rst index 0aa002314..171d295d2 100644 --- a/docs/guides/onap-user/vfw-design-tutorial/index.rst +++ b/docs/guides/onap-user/vfw-design-tutorial/index.rst @@ -96,8 +96,12 @@ Let us start by creating the VLM 2. Create Vendor Software Product (VSP) -Prerequisite: Download VNF Heat package from gerrit (git clone "https://gerrit.onap.org/r/demo") and copy -the required HEAT package & use it while upload the package +Prerequisite: Download VNF Heat package from gerrit + +.. code: bash + git clone "https://gerrit.onap.org/r/demo" + +and copy the required HEAT package & use it while upload the package A. Go to SDC Home → ONBOARD → WORKSPACE → CREATE NEW VSP (complete all the fields, click on Network Package checkbox then click create) |