Fixed broken/redirected links; Added linkcheck to test workflow

Signed-off-by: Andreas Maier <[email protected]>
zhmcclient · Nov 21, 2024 · e8a1d23 · e8a1d23
1 parent 2d39c92
commit e8a1d23
Show file tree

Hide file tree

Showing 7 changed files with 32 additions and 16 deletions.
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -257,6 +257,12 @@ jobs:
         RUN_TYPE: ${{ steps.set-run-type.outputs.result }}
       run: |
         make bandit
+    - name: Run linkcheck
+      env:
+        PACKAGE_LEVEL: ${{ matrix.package_level }}
+        RUN_TYPE: ${{ steps.set-run-type.outputs.result }}
+      run: |
+        make linkcheck
 
   test_finish:
     needs: test

diff --git a/docs/source/bibliography.rst b/docs/source/bibliography.rst
@@ -27,30 +27,37 @@ Resources
        The Web Services API of the z Systems Hardware Management Console, described in the following books:
 
    HMC API 2.11.1
-       `IBM SC27-2616, System z Hardware Management Console Web Services API (Version 2.11.1) <https://www.ibm.com/support/pages/node/6017542>`_
+       IBM SC27-2616, System z Hardware Management Console Web Services API (Version 2.11.1) (no longer available for download)
 
    HMC API 2.12.0
-       `IBM SC27-2617, System z Hardware Management Console Web Services API (Version 2.12.0) <https://www.ibm.com/support/pages/node/6019030>`_
+       IBM SC27-2617, System z Hardware Management Console Web Services API (Version 2.12.0) (no longer available for download)
 
    HMC API 2.12.1
-       `IBM SC27-2626, System z Hardware Management Console Web Services API (Version 2.12.1) <https://www.ibm.com/support/pages/node/6017614>`_
+       IBM SC27-2626, System z Hardware Management Console Web Services API (Version 2.12.1) (no longer available for download)
 
    HMC API 2.13.0
-       `IBM SC27-2627, z Systems Hardware Management Console Web Services API (Version 2.13.0) <https://www.ibm.com/support/pages/node/6018628>`_
+       `IBM SC27-2627-00a, z Systems Hardware Management Console Web Services API (Version 2.13.0) <https://www.ibm.com/docs/en/module_1707928542006/pdf/SC27-2627-00a.pdf>`_
 
    HMC API 2.13.1
-       `IBM SC27-2634, z Systems Hardware Management Console Web Services API (Version 2.13.1) <https://www.ibm.com/support/pages/node/6019732>`_
+       `IBM SC27-2634-03a, z Systems Hardware Management Console Web Services API (Version 2.13.1) <https://www.ibm.com/docs/en/module_1707928542006/pdf/SC27-2634-03a.pdf>`_
 
    HMC API 2.14.0
-       `IBM SC27-2636, IBM Z Hardware Management Console Web Services API (Version 2.14.0) <https://www.ibm.com/support/pages/node/6020008>`_
+       `IBM SC27-2636-04a, IBM Z Hardware Management Console Web Services API (Version 2.14.0) <https://www.ibm.com/docs/en/module_1687361734185/pdf/SC27-2636-04a.pdf>`_
 
    HMC API 2.14.1
-       `IBM SC27-2637, IBM Z Hardware Management Console Web Services API (Version 2.14.1) <https://www.ibm.com/support/pages/node/6019768>`_
+       `IBM SC27-2637-01a, IBM Z Hardware Management Console Web Services API (Version 2.14.1) <https://www.ibm.com/docs/en/module_1687361734185/pdf/SC27-2637-01a.pdf>`_
 
    HMC API 2.15.0
-       `IBM SC27-2638, IBM Z Hardware Management Console Web Services API (Version 2.15.0) <https://www.ibm.com/support/pages/node/6019720>`_
+       `IBM SC27-2638-04c, IBM Z Hardware Management Console Web Services API (Version 2.15.0) <https://www.ibm.com/docs/en/module_1687296212988/pdf/SC27-2638-04c.pdf>`_
        (covers both GA1 and GA2)
 
+   HMC API 2.16.0
+       `IBM SC27-2642-02, IBM Z Hardware Management Console Web Services API (Version 2.16.0) <https://www.ibm.com/docs/en/module_1675371155154/pdf/SC27-2642-02.pdf>`_
+       (covers both GA1 and GA2)
+
+   HMC Security
+       `IBM SC28-6987-01, Hardware Management Console Security <https://www.ibm.com/docs/en/module_1687361734185/pdf/SC28-6987-01.pdf>`_
+
 .. _`Java regular expressions`:
 
    Java regular expressions
@@ -59,4 +66,4 @@ Resources
 .. _`CoD Users Guide`:
 
    Capacity on Demand User's Guide
-       `IBM SC28-6985, IBM Z Capacity on Demand User's Guide <https://www.ibm.com/support/pages/node/6018790>`_
+       `IBM SC28-6985, IBM Z Capacity on Demand User's Guide <https://www.ibm.com/support/pages/sites/default/files/inline-files/SC28-6985-04.pdf>`_
diff --git a/docs/source/development.rst b/docs/source/development.rst
@@ -290,7 +290,7 @@ local clone of the zhmc-ansible-modules Git repo.
     Roll back the PR into any maintained stable branches.
 
 4.  Check for any
-    `dependabot alerts <https://github.com/zhmcclient/zhmc-ansible-modules/security/dependabot>`_.
+    `dependabot alerts <https://github.com/zhmcclient/zhmc-ansible-modules/security>`_.
 
     If there are any dependabot alerts, fix them in a separate branch/PR.
 

diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -124,7 +124,7 @@ please open an issue in the `issue tracker`_.
 .. _`issue tracker`:
    https://github.com/zhmcclient/zhmc-ansible-modules/issues
 .. _Apache 2.0 License:
-   https://opensource.org/licenses/Apache-2.0
+   https://opensource.org/license/apache-2-0
 .. _ibm.ibm_zhmc collection on Ansible Galaxy:
    https://galaxy.ansible.com/ibm/ibm_zhmc/
 .. _ibm.ibm_zhmc collection on Ansible AutomationHub:
@@ -134,6 +134,6 @@ please open an issue in the `issue tracker`_.
 .. _Ansible:
    https://www.ansible.com/
 .. _IBM Z:
-   https://www.ibm.com/it-infrastructure/z
+   https://www.ibm.com/z
 .. _LinuxONE:
-   https://www.ibm.com/it-infrastructure/linuxone/
+   https://www.ibm.com/linuxone
diff --git a/docs/source/installation.rst b/docs/source/installation.rst
@@ -51,7 +51,7 @@ Standard installation with system Python
 All commands shown are to be executed in a terminal or command prompt on the
 control system. The instructions are written for a bash shell.
 
-.. _`Installing Ansible on specific operating systems`: https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html#installing-ansible-on-specific-operating-systems
+.. _`Installing Ansible on specific operating systems`: https://docs.ansible.com/ansible/latest/installation_guide/installation_distros.html
 
 1.  Install Ansible as an operating system package on the control system.
 

diff --git a/docs/source/playbooks.rst b/docs/source/playbooks.rst
@@ -35,8 +35,8 @@ The **IBM Z HMC collection** provides sample playbooks in the
 The starting point for reading about them is `IBM Z HMC Sample Playbooks`_.
 
 .. _Ansible playbook:
-   https://docs.ansible.com/ansible/latest/user_guide/playbooks_intro.html#playbooks-intro
+   https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_intro.html
 .. _IBM Z Ansible Collection Samples:
    https://github.com/IBM/z_ansible_collections_samples/
 .. _IBM Z HMC Sample Playbooks:
-   https://github.com/IBM/z_ansible_collections_samples/tree/master/z_systems_administration/zhmc
+   https://github.com/IBM/z_ansible_collections_samples/tree/main/z_systems_administration/zhmc
diff --git a/docs/source/release_notes.rst b/docs/source/release_notes.rst
@@ -54,6 +54,9 @@ Availability: `AutomationHub`_, `Galaxy`_, `GitHub`_
 
 * Dev: Fixed new issue 'too-many-positional-arguments' reported by Pylint 3.3.0.
 
+* Docs: Fixed broken links to IBM documentation and updated permanently
+  redirected links.
+
 **Enhancements:**
 
 * Support for ansible-core 2.18, by adding an ignore file for the sanity tests.