Skip to content

fix: resolve broken links in link checker#5063

Merged
balhar-jakub merged 2 commits into
masterfrom
balhar-jakub/fix-link-checker-errors
Jun 18, 2026
Merged

fix: resolve broken links in link checker#5063
balhar-jakub merged 2 commits into
masterfrom
balhar-jakub/fix-link-checker-errors

Conversation

@balhar-jakub

Copy link
Copy Markdown
Member

Summary

Fixes 7 pre-existing broken links across 5 files that cause the CI link checker to fail on master.

Changes

🔴 Fixed internal link errors

File What was broken Fix
docs/troubleshoot/app-framework/appserver-error-codes.md certificate-configuration-scenarios.md (wrong filename — should be plural) certificates-configuration-scenarios.md (2 occurrences, also fixed fragment to match actual heading)
docs/user-guide/zos-preflight.md Link to commands/internal/start/prepare/index.ts (TypeScript source file, not a doc page) ../appendix/zwe_server_command_reference/zwe/internal/start/zwe-internal-start-prepare.md

🟡 Fixed live docs.zowe.org 404s

File Broken URL Fix
docs/troubleshoot/cli/troubleshoot-cli-credentials.md https://docs.zowe.org/stable/user-guide/use-certificates/ (404) cli-using-working-certificates
docs/user-guide/api-mediation/configuration-saf-resource-checking.md https://docs.zowe.org/stable/user-guide/zss-api/ (404 — page removed in V3) getting-started/zowe-architecture/#zss

⚪ Fixed retired IBM Knowledge Center links

File Broken URL Fix
docs/user-guide/cli-swreqplugins.md IBM KC CICS 5.2 welcome page (404) https://www.ibm.com/docs/en/cics-ts/5.2
docs/user-guide/cli-swreqplugins.md IBM KC CICS CMCI overview (404) https://www.ibm.com/docs/en/cics-ts/5.2?topic=programming-cics-management-client-interface
docs/user-guide/cli-swreqplugins.md IBM KC MQ 9.1 (404) https://www.ibm.com/docs/en/ibm-mq/9.1

Not addressed (transient / PR-specific)

Verification

  • All 7 fixes are targeted file-only changes with no structural impact
  • No changes to sidebars, build config, or generated files
    END_OF_BODY
    2>&1

Fixes multiple pre-existing link checker failures:

- Fix filename: certificate-configuration-scenarios → certificates-configuration-scenarios
  (docs/troubleshoot/app-framework/appserver-error-codes.md, 2 occurrences)
- Fix broken internal link to zwe internal start prepare reference page
  (docs/user-guide/zos-preflight.md)
- Fix 404: use-certificates → cli-using-working-certificates
  (docs/troubleshoot/cli/troubleshoot-cli-credentials.md)
- Fix 404: zss-api → zowe-architecture#zss
  (docs/user-guide/api-mediation/configuration-saf-resource-checking.md)
- Fix IBM Knowledge Center 404s → ibm.com/docs equivalents
  (docs/user-guide/cli-swreqplugins.md — CICS 5.2 and MQ 9.1 links)

Signed-off-by: balhar-jakub <balhar.jakub@gmail.com>
@github-actions

Copy link
Copy Markdown

😺 Thank you for creating this PR! To publish your content to Zowe Docs, follow these required steps.

  • Add the label review: doc.
  • Identify your content topic with a label. (Examples: area: apiml, area: cli, area: install and config, etc.)
  • Specify the major Zowe release(s) for your content. (Examples: release: V1, release: V2, release: V3)
    • If adding content that needs to be removed from V3 documentation, add the V3 N/A tag.
  • Select the master branch if your PR updates content that is on the live site. Select docs-staging if your PR updates content for a future release.
  • Notify the Doc Squad about this PR. If you don't know whom should review your content, message the #zowe-doc Slack channel. If you know which Doc Squad writer should approve your content, add that person as a reviewer.

Need help? Contact the Doc Squad in the #zowe-doc Slack channel.

@balhar-jakub balhar-jakub self-assigned this Jun 18, 2026
@balhar-jakub balhar-jakub requested a review from janan07 June 18, 2026 09:35
@balhar-jakub balhar-jakub added area: docs Documentation issue or issues that have documentation impact release: V3 Zowe V3 content review: doc Needs review by Doc Squad member labels Jun 18, 2026
@github-actions

github-actions Bot commented Jun 18, 2026

Copy link
Copy Markdown

@github-actions github-actions Bot temporarily deployed to pull request June 18, 2026 09:40 Inactive
Signed-off-by: Andrew Jandacek <andrew.jandacek@broadcom.com>

@janan07 janan07 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated the links so Zowe Docs links are local. Thanks for the PR.

@github-actions github-actions Bot temporarily deployed to pull request June 18, 2026 10:10 Inactive
@balhar-jakub balhar-jakub merged commit cfb5123 into master Jun 18, 2026
3 of 4 checks passed
@balhar-jakub balhar-jakub deleted the balhar-jakub/fix-link-checker-errors branch June 18, 2026 10:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Documentation issue or issues that have documentation impact release: V3 Zowe V3 content review: doc Needs review by Doc Squad member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants