Skip to content

Fix link check false positive for npm, add link text, update container docs - #257

Merged
kthoms merged 4 commits into
mainfrom
fix/link-check-and-container-docs
Nov 21, 2026
Merged

kthoms merged 4 commits into
mainfrom
fix/link-check-and-container-docs

Conversation

@kthoms

@kthoms kthoms commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #237

Link check

  • npm false positive: npmjs.com returns 403 to every automated request, even with a browser user agent. lychee now remaps npmjs.com/package/<pkg> to registry.npmjs.org/<pkg>, so missing packages are still detected. Failures are reported under the original docs URL, using lychee's remap.original.
  • Link text column: report tables are now Page | Line | Text | URL | Status. The text is extracted from Markdown links, reference definitions, autolinks, <a> and <img alt> tags, and from links in the REST API spec. The map JSON output includes it too.

Container documentation

  • security.md: removed JBoss EAP and the dead docs.jboss.org, docs.redhat.com and wildscribe links. Links now go to Tomcat 11.0, WildFly 41, Spring Boot 4.1 and Quarkus 3.40 (newly added). Spring Boot links now reference ErrorProperties.IncludeAttribute and spring.web.error.include-stacktrace.
  • supported-environments.md: the container-managed engine section now lists Tomcat 11.0 and WildFly 41. These are the versions in the Operaton 2.2.2 parent/pom.xml, and the ones the integration build tests.
  • update_versions.py reads version.tomcat, version.wildfly, version.spring-boot and version.quarkus from the release's pom.xml and parent/pom.xml. It then updates these list items and the versioned doc URLs on the pages in CONTAINER_DOC_FILES.

Supported databases

Checked against the Operaton 2.2.2 CI, using the database/pom.xml testcontainers profiles and version.h2:

DB Before CI tests Now
MySQL 8.0 8.4 8.4 (8.0 reached EOL in April 2026)
MariaDB – 10.11 10.11 (new)
Oracle 19c / 23ai 21c 19c / 21c / 26ai (23ai is now marketed as 26ai)
DB2 11.5 12.1 11.5 / 12.1
PostgreSQL 14 / 15 / 16 14 unchanged
SQL Server 2017 / 2019 / 2022 2022 unchanged
H2 2.3 2.5 2.5

Versions and products the CI does not test stay listed: PostgreSQL 15/16, SQL Server 2017/2019, Oracle 19c/23ai, DB2 11.5, Aurora and Azure SQL. update_versions.py adds a tested version when it is missing from the list, and replaces the H2 version because H2 is the bundled driver.

An "End of Vendor Support" note says that versions are removed with the first Operaton minor release after their vendor's end of support: DB2 11.5 on 30 April 2027, SQL Server 2017 on 12 October 2027, and Oracle 19c on 31 December 2029 (Premier Support).

Verification

  • python3 -m unittest discover -s .devenv/scripts/tests: 168 tests pass
  • External link check on security.md and mcp-server.md: 0 broken links
  • update_versions.py --dry-run: no changes needed, the pages are current

🤖 Generated with Claude Code

kthoms and others added 2 commits November 21, 2026 06:36
npmjs.com answers 403 to all automated requests, so package pages were
reported as broken. lychee now remaps them to the npm registry API and
failures are reported under the URL written in the docs.

The report tables get a "Text" column with the link text, so broken
links are easier to find on the rendered page.

Refs #237

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
security.md linked docs for Tomcat 9, WildFly 12, JBoss EAP 7 and
Spring Boot 2.3. Links now point to Tomcat 11.0, WildFly 41, Spring Boot
4.1 and Quarkus 3.40 (newly added); JBoss EAP is removed. The supported
environments page lists Tomcat 11.0 and WildFly 41, the versions Operaton
2.2.2 is built and tested with.

update_versions.py reads the container versions from the Operaton pom
files of the latest release and keeps these pages in sync.

Fixes #237

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings November 21, 2026 05:36

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

kthoms and others added 2 commits November 21, 2026 06:42
Operaton 2.2.2 CI tests MySQL 8.4, MariaDB 10.11, Oracle 21c, DB2 12.1,
PostgreSQL 14, SQL Server 2022 and H2 2.5 (database/pom.xml). The page
listed MySQL 8.0 (EOL), H2 2.3, no MariaDB, and lacked Oracle 21c and
DB2 12.1. Other listed versions stay.

update_versions.py reads the testcontainers image tags and version.h2
from database/pom.xml of the latest release and adds a tested version
missing from the list; H2 is replaced as it is the bundled driver.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Oracle markets 23ai as 26ai since release update 23.26. The supported
environments page lists the dates when DB2 11.5, SQL Server 2017 and
Oracle 19c leave vendor support; they are removed with the first
Operaton minor release after that.

update_versions.py labels Oracle 23 images as 26ai and leaves the end
of support note untouched.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kthoms
kthoms merged commit c68c3e8 into main Nov 21, 2026
3 checks passed
@kthoms
kthoms deleted the fix/link-check-and-container-docs branch November 21, 2026 05:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Broken links in documentation

2 participants