[DOC] Remove warnings from documentation build

conf.py => use add_css_file as recommended
oom_developer_guide.rst => suppres anchor for nexus link

oom_user_guide.rst =>
- modify anchor for K8S link
- add `` fo http example to avoid link to be checked

For release-notes-<Release>.rst and oom_hardcoded_certificates.rst =>
- add :orphan: directive because rst file not in toctree

Issue-ID: OOM-2646

Signed-off-by: Eric Debeau <eric.debeau@orange.com>
Change-Id: Icfecde7807e2417a1825f25a1d57a1830c4222a0

diff --git a/docs/conf.py b/docs/conf.py
index 8f40e8b..3b28eb7 100644 (file)
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -12,4 +12,4 @@ intersphinx_mapping = {}
 html_last_updated_fmt = '%d-%b-%y %H:%M'
 
 def setup(app):
-    app.add_stylesheet("css/ribbon_onap.css")
+    app.add_css_file("css/ribbon_onap.css")

diff --git a/docs/oom_developer_guide.rst b/docs/oom_developer_guide.rst
index fccf453..3d8cdb1 100644 (file)
--- a/docs/oom_developer_guide.rst
+++ b/docs/oom_developer_guide.rst
@@ -8,7 +8,7 @@
 .. _Helm Charts: https://github.com/kubernetes/charts
 .. _Kubernetes: https://Kubernetes.io/
 .. _Docker: https://www.docker.com/
-.. _Nexus: https://nexus.onap.org/#welcome
+.. _Nexus: https://nexus.onap.org/
 .. _AWS Elastic Block Store: https://aws.amazon.com/ebs/
 .. _Azure File: https://docs.microsoft.com/en-us/azure/storage/files/storage-files-introduction
 .. _GCE Persistent Disk: https://cloud.google.com/compute/docs/disks/
@@ -1131,7 +1131,7 @@ access to watch the kubernetes events and get service annotation by
 Kubernetes APIs. The token can be found in the kubectl configuration file
 *~/.kube/config*
 
-More details can be found here `MSB installation <http://onap.readthedocs.io/en/latest/submodules/msb/apigateway.git/docs/platform/installation.html>`__.
+More details can be found here `MSB installation <https://docs.onap.org/projects/onap-msb-apigateway/en/latest/platform/installation.html>`_.
 
 .. MISC
 .. ====

diff --git a/docs/oom_hardcoded_certificates.rst b/docs/oom_hardcoded_certificates.rst
index 9f6aa1f..c4392c7 100644 (file)
--- a/docs/oom_hardcoded_certificates.rst
+++ b/docs/oom_hardcoded_certificates.rst
@@ -3,6 +3,8 @@
 .. http://creativecommons.org/licenses/by/4.0
 .. Copyright 2018 Amdocs, Bell Canada, 2020 Nokia Solutions and Networks
 
+:orphan:
+
 .. Links
 .. _hardcoded-certificates-label:
 

diff --git a/docs/oom_user_guide.rst b/docs/oom_user_guide.rst
index 70f19df..ac716a3 100644 (file)
--- a/docs/oom_user_guide.rst
+++ b/docs/oom_user_guide.rst
@@ -12,7 +12,7 @@
 .. _Helm Documentation: https://docs.helm.sh/helm/
 .. _Helm: https://docs.helm.sh/
 .. _Kubernetes: https://Kubernetes.io/
-.. _Kubernetes LoadBalancer: https://kubernetes.io/docs/concepts/services-networking/service/#type-loadbalancer
+.. _Kubernetes LoadBalancer: https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer
 .. _user-guide-label:
 
 OOM User Guide
@@ -414,7 +414,7 @@ below::
 
 Ensure you've disabled any proxy settings the browser you are using to access
 the portal and then simply access now the new ssl-encrypted URL:
-https://portal.api.simpledemo.onap.org:30225/ONAPPORTAL/login.htm
+``https://portal.api.simpledemo.onap.org:30225/ONAPPORTAL/login.htm``
 
 .. note::
   Using the HTTPS based Portal URL the Browser needs to be configured to accept
@@ -481,7 +481,7 @@ have been created - a sample from the ONAP Integration labs follows:
 .. figure:: consulHealth.png
    :align: center
 
-To see the real-time health of a deployment go to: http://<kubernetes IP>:30270/ui/
+To see the real-time health of a deployment go to: ``http://<kubernetes IP>:30270/ui/``
 where a GUI much like the following will be found:
 
 

diff --git a/docs/release-notes-amsterdam.rst b/docs/release-notes-amsterdam.rst
index 79d2e30..6fc2296 100644 (file)
--- a/docs/release-notes-amsterdam.rst
+++ b/docs/release-notes-amsterdam.rst
@@ -5,6 +5,8 @@
 .. reserved.
 .. _release_notes_amsterdam:
 
+:orphan:
+
 ONAP Operations Manager Release Notes
 =====================================
 

diff --git a/docs/release-notes-beijing.rst b/docs/release-notes-beijing.rst
index 1af7c58..1172a08 100644 (file)
--- a/docs/release-notes-beijing.rst
+++ b/docs/release-notes-beijing.rst
@@ -5,6 +5,8 @@
 .. reserved.
 .. _release_notes_beijing:
 
+:orphan:
+
 ONAP Operations Manager Release Notes
 =====================================
 

diff --git a/docs/release-notes-casablanca.rst b/docs/release-notes-casablanca.rst
index f983c59..6a6a196 100644 (file)
--- a/docs/release-notes-casablanca.rst
+++ b/docs/release-notes-casablanca.rst
@@ -5,6 +5,8 @@
 .. reserved.
 .. _release_notes_casablanca:
 
+:orphan:
+
 ONAP Operations Manager Release Notes
 =====================================
 

diff --git a/docs/release-notes-dublin.rst b/docs/release-notes-dublin.rst
index e948af5..1974756 100644 (file)
--- a/docs/release-notes-dublin.rst
+++ b/docs/release-notes-dublin.rst
@@ -5,6 +5,8 @@
 .. reserved.
 .. _release_notes_dublin:
 
+:orphan:
+
 ONAP Operations Manager Release Notes
 =====================================
 

diff --git a/docs/release-notes-elalto.rst b/docs/release-notes-elalto.rst
index 435889e..bbbf271 100644 (file)
--- a/docs/release-notes-elalto.rst
+++ b/docs/release-notes-elalto.rst
@@ -5,6 +5,8 @@
 .. reserved.
 .. _release_notes_elalto:
 
+:orphan:
+
 ONAP Operations Manager Release Notes
 =====================================
 

diff --git a/docs/release-notes-frankfurt.rst b/docs/release-notes-frankfurt.rst
index da3ae2a..7bd4474 100644 (file)
--- a/docs/release-notes-frankfurt.rst
+++ b/docs/release-notes-frankfurt.rst
@@ -4,6 +4,8 @@
 .. (c) ONAP Project and its contributors
 .. _release_notes_frankfurt:
 
+:orphan:
+
 *************************************
 ONAP Operations Manager Release Notes
 *************************************