================================================================================ RHBQ Documentation Link Check Report ================================================================================ Date: 2025-12-04 16:20:12 RHBQ Version: 3.27 Total Guides Checked: 38 URL List: internal-docs/list-of-ibm-docs-urls.txt Timeout: 30 seconds ================================================================================ SUMMARY ================================================================================ ✓ overview-learn-whats-new-in-327 (116 links) ✓ overview-licensing-enterprise-build-quarkus (15 links) ✓ overview-notices (15 links) ✓ build-your-first-application (49 links) [7 IBM OK] ✓ applications-develop-compile-apache-maven (35 links) [4 IBM OK] ✓ applications-compile-native-executables (33 links) ✓ platform-choose-deployment-strategy (30 links) [4 IBM OK] ✓ platform-deploy-in-single-step (16 links) [1 IBM OK] ✓ platform-deploy-docker-build (15 links) [1 IBM OK] ✓ platform-deploy-source-image-s2i (17 links) [1 IBM OK] ✓ platform-deploy-native-executables (15 links) [1 IBM OK] ✓ applications-use-applicationproperties-configure (31 links) ✓ applications-use-applicationyaml-configure (23 links) ✗ applications-configure-jdbc-reactive-data-sources (1 errors, 1 TIMEOUT) ✓ applications-set-up-logging-output-apis (32 links) ✓ applications-understand-quarkus-security-overview (38 links) [11 IBM OK] ✓ security-build-secure-application-basic-authentication (30 links) [8 IBM OK] ✓ security-store-user-identities-jakarta-persistence (25 links) [6 IBM OK] ✓ architecture-learn-quarkus-security (21 links) [6 IBM OK] ✓ architecture-choose-authentication-mechanism (34 links) [16 IBM OK] ✓ architecture-understand-identity-providers (20 links) [4 IBM OK] ✓ architecture-configure-proactive-authentication (23 links) [5 IBM OK] ✓ authentication-understand-basic (21 links) [7 IBM OK] ✓ authentication-enable-basic (22 links) [5 IBM OK] ✓ oidc-understand-bearer-token-authentication (44 links) [14 IBM OK] ✓ ao-protect-service-application-by-using-oidc-bearer-token-authentication (40 links) [7 IBM OK] ✓ oidc-understand-authorization-code-flow (69 links) [15 IBM OK] ✓ ao-protect-web-application-by-using-oidc-authorization-code-flow (39 links) [8 IBM OK] ✓ oidc-use-multitenancy (43 links) [6 IBM OK] ✓ oidc-configuration-properties (30 links) [4 IBM OK] ✓ oidc-centralize-authorization-keycloak (43 links) [6 IBM OK] ✓ propagation-learn-oidc-client-token (31 links) [3 IBM OK] ✓ propagation-oidc-oauth2-client-filters-reference (33 links) [5 IBM OK] ✓ applications-manage-authorization-web-endpoints (31 links) [8 IBM OK] ✓ applications-configure-tls-connections-security-keys-certificates (20 links) [2 IBM OK] ✓ applications-configure-cross-origin-resource-sharing-cors (20 links) [1 IBM OK] ✓ jwt-use-rbac (40 links) [7 IBM OK] ✓ jwt-build-sign-encrypt-json-web-tokens (25 links) [3 IBM OK] ================================================================================ STATISTICS ================================================================================ Total Guides Checked: 38 Passed: 37 Failed: 1 IBM Images Verified OK: 176 IBM Images NOT Found: 0 Known Issues Found: 4 (safe to ignore) Timeout Errors: 1 Success Rate: 97.4% ================================================================================ KNOWN ISSUES (Safe to Ignore) ================================================================================ The following errors are expected due to LinkChecker limitations: 1. "URL host 'host:port' has invalid port" - URLs like https://host:port/auth or https://host:port/realms/{realm} - These are documentation placeholders using literal "port" text - LinkChecker cannot skip syntax-invalid URLs - Safe to ignore - not real broken links 2. Comma-separated URL lists - URLs like http://www.quarkus.io,http://localhost:3000 - These are examples showing configuration format - Already filtered by ignore patterns - Should not appear in error logs 3. Maven Central 403 Forbidden errors - URLs like https://search.maven.org/artifact/org.wiremock/wiremock - Maven Central blocks automated bots/scrapers with 403 Forbidden - These links work fine for humans in a web browser - Verify manually if needed - not broken documentation 4. IBM docs misresolved image paths (AUTOMATICALLY VERIFIED) - URLs like https://www.ibm.com/docs/en/quarkus/resources/images/... - IBM docs uses ?topic= URL routing but serves content from SSOPG63_3.27.0 path - LinkChecker resolves relative image paths against wrong base URL - This script automatically verifies images at the corrected path - If verified OK, the error is NOT counted; if not found, it IS a real error If you see these errors, they do NOT indicate broken documentation. All other errors should be investigated and fixed. ================================================================================ *** TIMEOUT LIMIT REACHED *** ================================================================================ 1 links exceeded the timeout limit of 30 seconds. This indicates slow server responses or network issues, not broken links. RECOMMENDED ACTION: Re-run with increased timeout: ./scripts/check-doc-links.py --file internal-docs/list-of-ibm-docs-urls.txt --timeout 60 Timeout errors should be investigated separately from broken links. ================================================================================ DETAILED ERROR INFORMATION BY GUIDE ================================================================================ The following section provides detailed error information for each failed guide. This allows you to trace specific failures to exact URLs and error messages. ════════════════════════════════════════════════════════════════ FAILED GUIDE: applications-configure-jdbc-reactive-data-sources ════════════════════════════════════════════════════════════════ URL: https://www.ibm.com/docs/en/quarkus/3.27.x?topic=applications-configure-jdbc-reactive-data-sources Total Errors: 1 *** TIMEOUT LIMIT REACHED: 1 links *** Consider increasing timeout: ./scripts/check-doc-links.py --file internal-docs/list-of-ibm-docs-urls.txt --timeout 60 Error Details: ──────────────────────────────────────────────────────────────── URL https://github.com/quarkusio/quarkus/issues Name issue tracker Parent URL https://www.ibm.com/docs/en/quarkus/3.27.x?topic=applications-configure-jdbc-reactive-data-sources, line 1010, col 42 Real URL https://github.com/quarkusio/quarkus/issues Check time 31.479 seconds Result Error: ReadTimeout: HTTPSConnectionPool(host='github.com', port=443): Read timed out. (read timeout=30)