Skip to content

Update external support links#153

Open
hauptmedia wants to merge 33 commits into
mainfrom
codex/update-external-support-links
Open

Update external support links#153
hauptmedia wants to merge 33 commits into
mainfrom
codex/update-external-support-links

Conversation

@hauptmedia

@hauptmedia hauptmedia commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Summary

  • replace the old Camunda Jira issue tracker link with Operaton GitHub issues

  • replace stale or dead external support links with current canonical targets

  • remove dead Camunda/XLTS/blog references from third-party and diagnostics pages where no current target exists

  • update stale operaton-bpm-platform GitHub repository links to the current operaton/operaton repository

  • update stale operaton/operaton GitHub links from master to main where the current targets exist

  • update dead operaton-bpm-examples links to the current operaton/operaton-examples catalog where matching examples exist

  • remove old example links where the current examples catalog has no equivalent target

  • update security-page OWASP and Red Hat references to current canonical pages, including the OWASP XXE cheat sheet

  • update logging/framework references to HTTPS/canonical documentation URLs, including SLF4J, Log4j, Logback, Tomcat, WildFly, IronJacamar, FreeMarker, Velocity, bpmn.io, MyBatis, Moment, Less, Bootstrap, Jakarta REST, and Operaton Javadocs

  • update the Architecture page to use the current Jakarta REST specification link, switch remaining HTTP reference links to HTTPS, and remove the dead operaton-bpmn.js repository entry

  • use HTTPS for Tomcat home and Tomcat 9 Resource Links references in the Tomcat installation/integration pages

  • replace the old external operaton.org/download WildFly subsystem note with the local full-distribution download documentation link

  • replace the remaining Camunda job-executor blog reference in the logging guide with the local Job Executor documentation

  • replace a stale public quick-start URL with an internal docs route and remove dead operaton-bpmn.js / operaton-template-engines-jsr223 repository references

  • replace dead webapp translations repository links with current Admin, Cockpit, and Tasklist locale directories in operaton/operaton

  • replace stale standalone Forms SDK Bower distribution links with the current SDK source tree in operaton/operaton and clarify that no separate Operaton Bower release repository is published

  • replace the dead standalone operaton-dmn-model repository link with the local DMN Model API documentation

  • replace stale public docs.operaton.org/docs/documentation/... self-links in Security and Cockpit plugin docs with local documentation references or inline wording

  • update remaining HTTP reference links in introduction, BPMN/CMMN date docs, REST authentication/HAL docs, Spin JSON docs, expression-language docs, Tasklist filters, and Spring Boot REST docs, using current canonical targets for HAL, Jackson, and Spring Boot properties

  • remove the stale BPM Guide retry article link from the error-handling guide and switch the Spin XML JDK reference to HTTPS

  • fix malformed DMN Javadoc method anchors that used a double hash and stale spacing in decision evaluation docs

  • replace stale or bot-blocked Rhino, Nashorn, Jackson, and Spring Boot reference links with current project or official documentation targets

  • polish wording in the updated Security, Admin plugin, and Tasklist plugin pages without changing their technical guidance

Verification

  • rg -n -i "\\b(a Operaton|listed those|allow to reuse|can not be|does not allow to provide)\\b" docs/documentation/webapps/tasklist/tasklist-plugins.md docs/documentation/webapps/admin/plugins.md docs/documentation/user-guide/security.md -S returns no matches
  • rg -n "developer\\.mozilla\\.org/de/docs/Rhino|blogs\\.oracle\\.com/nashorn|medium\\.com/@cowtowncoder|baeldung\\.com/spring-boot-configure-tomcat" docs/documentation/user-guide/dmn-engine/expressions-and-scripts.md docs/documentation/user-guide/security.md -S returns no matches
  • curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" returned 200 for the replacement Rhino, Nashorn, Jackson 2.10, and Spring Boot application-properties targets
  • rg -n "##evaluateDecisionTable|evaluateDecisionTable\([^)]*, java\.util\.Map\)|DecisionService\.html##" docs/documentation/user-guide/dmn-engine/evaluate-decisions.md docs/documentation/user-guide/process-engine/decisions/decision-service.md -S returns no matches
  • fetched the current DmnEngine.html and DecisionService.html Javadocs and confirmed the replacement method ids evaluateDecisionTable(org.operaton.bpm.dmn.engine.DmnDecision,java.util.Map) and evaluateDecisionTableByKey(java.lang.String) exist
  • rg -n "http://docs\.oracle\.com/javase/8/docs/api|www\.bpm-guide\.de/2012/06/15/where-is-the-retry-in-bpmn-2-0" docs/documentation/reference/spin/xml/06-configuring-xml.md docs/documentation/user-guide/process-engine/error-handling.md -S returns no matches
  • curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" https://docs.oracle.com/javase/8/docs/api/ returns 200; the removed BPM Guide URL now redirects to the Camunda homepage instead of the original article
  • rg -n "http://(bpmn\.io|semver\.org|en\.wikipedia\.org/wiki/ISO_8601|www\.quartz-scheduler\.org|en\.wikipedia\.org/wiki/Basic_access_authentication|docs\.jboss\.org/resteasy|docs\.oracle\.com/javaee|stateless\.co/hal_specification|goessner\.net/articles/JsonPath|wiki\.fasterxml\.com/JacksonHome|juel\.sourceforge\.net|joda-time\.sourceforge\.net|www\.joda\.org/joda-time|docs\.spring\.io/spring-boot/docs/current/reference/html/common-application-properties\.html)|http://www\.omg\.org/spec/DMN/|http://angular-ui\.github\.io/bootstrap" <updated HTTP reference files> -S finds no matches
  • curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" returned 200 for the updated bpmn.io, SemVer, ISO 8601, Quartz, Angular UI Bootstrap, HTTP Basic Authentication, RESTEasy, Oracle Java EE API, HAL IETF draft, JSONPath, Jackson, JUEL, DMN, Joda-Time, and Spring Boot application properties targets
  • rg -n "app\\.camunda\\.com/jira|jira\\.camunda|camunda\\.com/blog/2022/02/ensuring-continuous-support-of-angularjs|blog\\.camunda\\.com/post/2019/10/job-executor|downstream-eula|docs\\.camunda\\.org/enterprise|Enterprise Edition|Camunda Enterprise|Operaton Enterprise" docs/documentation/introduction/third-party-libraries/index.md docs/documentation/user-guide/process-engine/diagnostics-data.md docs/documentation/user-guide/logging.md -S
  • rg -n "camunda\\.com|blog\\.camunda|docs\\.camunda|app\\.camunda|github\\.com/camunda" <updated files> -S finds no matches
  • rg -n "\\]\\s+\\(https?://|www\\.owasp\\.org/index\\.php|github\\.com/OWASP/CheatSheetSeries/blob/[0-9a-f]+|github\\.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/XML_External_Entity_Prevention_Cheat_Sheet\\.md" docs/documentation/user-guide/security.md -S finds no matches for malformed markdown or stale OWASP targets
  • rg -n "access\\.redhat\\.com|Model Refernce" docs/documentation/user-guide/security.md -S finds no matches
  • curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" https://cheatsheetseries.owasp.org/cheatsheets/XML_External_Entity_Prevention_Cheat_Sheet.html returns 200
  • rg -n "http://(www\\.slf4j\\.org|logging\\.apache\\.org|logback\\.qos\\.ch)" docs/documentation/user-guide/logging.md -S finds no matches
  • rg -n "operaton/operaton-bpm-platform|tree/master/freemarker-template-engine|operaton-bpmn-platform" docs/documentation/installation/full/tomcat/manual.md docs/documentation/user-guide/process-engine/templating.md -S finds no matches
  • rg -n "https://github\\.com/operaton/operaton/(tree|blob)/master" docs/documentation/user-guide/logging.md docs/documentation/user-guide/process-engine/diagnostics-data.md docs/documentation/user-guide/process-engine/connectors.md docs/documentation/webapps/tasklist/tasklist-plugins.md docs/documentation/webapps/admin/plugins.md -S finds no matches
  • rg -n "operaton-bpm-examples|github\\.com/operaton/operaton/(tree|blob)/master" docs -S finds no matches
  • rg -n "http://tomcat\\.apache\\.org" docs/documentation/installation/full/tomcat/index.md docs/documentation/user-guide/runtime-container-integration/tomcat.md -S finds no matches
  • rg -n "operaton\\.org/download" docs/documentation/user-guide/runtime-container-integration/jboss.md -S finds no matches
  • rg -n "docs\\.operaton\\.org/get-started/quick-start|operaton-bpmn\\.js|operaton-template-engines-jsr223|operaton-webapp-translations|jax-rs-spec\\.java\\.net" docs/documentation/introduction/architecture.md docs/documentation/user-guide/operaton-bpm-run.md docs/documentation/user-guide/process-engine/process-diagram-api.md docs/documentation/user-guide/process-engine/templating.md docs/documentation/webapps/admin/configuration.md docs/documentation/webapps/cockpit/extend/configuration.md docs/documentation/webapps/tasklist/configuration.md -S finds no matches
  • PR-file URL checker: checked 121 urls across 32 files; problematic 0
  • rg -n "http://(tomcat\\.apache\\.org|www\\.wildfly\\.org|www\\.ironjacamar\\.org|docs\\.wildfly\\.org|docs\\.operaton\\.org/latest/api-references|bpmn\\.io|freemarker\\.org|velocity\\.apache\\.org|getbootstrap\\.com|www\\.mybatis\\.org|momentjs\\.com|lesscss\\.org)|jax-rs-spec\\.java\\.net" <updated files> -S finds no matches
  • canonical URL checks with curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" returned 200 for the updated Operaton, GitHub, OWASP, Red Hat, logging, examples, Tomcat, WildFly, IronJacamar, FreeMarker, Velocity, bpmn.io, MyBatis, Moment, Less, Bootstrap, Jakarta REST, and Javadocs targets
  • curl -s -o /dev/null -w "%{http_code}" -L https://tomcat.apache.org/ and curl -s -o /dev/null -w "%{http_code}" -L https://tomcat.apache.org/tomcat-9.0-doc/config/context.html#Resource_Links return 200
  • gh repo view operaton/bower-operaton-bpm-sdk-js confirms the old standalone Forms SDK Bower release repository is not published under Operaton
  • npm view operaton-bpm-sdk-js and npm view @operaton/bpm-sdk-js return 404, so the docs no longer claim an npm/Bower package install path
  • curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" https://github.com/operaton/operaton/tree/main/webapps/frontend/operaton-bpm-sdk-js returns 200
  • curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" returns 200 for https://www.wildfly.org/, https://mybatis.org/mybatis-3/, https://www.slf4j.org/, https://www.slf4j.org/manual.html, and https://logback.qos.ch/
  • gh repo view operaton/operaton-dmn-model confirms the old standalone DMN model repository is not published under Operaton; npm run build validates the replacement local ../model-api/dmn-model-api/ documentation link
  • rg -n -i "operaton/bower-operaton-bpm-sdk-js|bower install operaton-bpm-sdk-js|operaton-dmn-model|http://getbootstrap\.com|http://lesscss\.org|http://www\.wildfly\.org|http://www\.mybatis\.org|http://www\.slf4j\.org|http://logback\.qos\.ch|LOGBack" docs/documentation/introduction/architecture.md docs/documentation/webapps/admin/configuration.md docs/documentation/reference/forms/embedded-forms/integrate/getting-a-distribution.md docs/documentation/installation/full/wildfly/index.md docs/documentation/user-guide/dmn-engine/embed.md docs/documentation/user-guide/process-engine/database/database-configuration.md -S finds no matches
  • rg -n "docs\.operaton\.org/docs/documentation/(installation/full/tomcat/manual|webapps/cockpit/extend/plugins)" docs/documentation/user-guide/security.md docs/documentation/webapps/cockpit/extend/plugins.md -S finds no matches
  • npm run build validates the replacement relative Tomcat manual link in the Security guide
  • rg -n "http://angularjs\.org|http://requirejs\.org|http://jquery\.com|http://en\.wikipedia\.org/wiki/Command_pattern" docs/documentation/introduction/architecture.md -S finds no matches
  • curl -L -s -o /dev/null -w "%{http_code}" returns 200 for https://en.wikipedia.org/wiki/Command_pattern, https://angularjs.org, https://requirejs.org, and https://jquery.com
  • git diff --check
  • npm run typecheck
  • npm run build succeeds; Docusaurus still reports pre-existing broken link/anchor warnings outside this PR

Comment thread docs/documentation/installation/full/tomcat/manual.md Outdated

* [CallActivityContextSwitchTest](https://github.com/operaton/operaton-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/operaton/bpm/integrationtest/functional/context/CallActivityContextSwitchTest.java)
* [CdiBeanCallActivityResolutionTest](https://github.com/operaton/operaton-bpm-platform/blob/f37877b822dabcbf3cee5806bd5833d18cdcb543/qa/integration-tests-engine/src/test/java/org/operaton/bpm/integrationtest/functional/cdi/CdiBeanCallActivityResolutionTest.java)
* [CallActivityContextSwitchTest](https://github.com/operaton/operaton/blob/main/qa/integration-tests-engine/src/test/java/org/operaton/bpm/integrationtest/functional/context/CallActivityContextSwitchTest.java)

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.

Note to myself: Check if they are still failing


### XLTS for AngularJS

Starting with versions 7.18.0-alpha2, 7.17.2, 7.16.9, 7.15.15, the Operaton web applications use a set of third-party libraries referred to as *XLTS for AngularJS* (technical names: `angular`, `angular-animate`, `angular-cookies`, `angular-loader`, `angular-mocks`, `angular-resource`, `angular-route`, `angular-sanitize`, `angular-touch`). XLTS for AngularJS follows a proprietary license called *EULA for the downstream recipient of XLTS for AngularJS* (short *XLTS for AngularJS – EULA*) that you can find [here](https://xlts.dev/angularjs/downstream-eula).

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.

These libraries are still in use by the old webapps. Please leave this section and just remove the "Starting with..." statement.

Comment thread docs/documentation/introduction/architecture.md Outdated
Comment thread docs/documentation/reference/rest/overview/hal.md Outdated
Comment thread docs/documentation/user-guide/runtime-container-integration/tomcat.md Outdated
If you add JSF forms as described below, you can easily use them as <br/>
[external task forms](../task-forms/index.md#external-task-forms).

A working example can be found in the [examples repository](https://github.com/operaton/operaton-bpm-examples/tree/master/usertask/task-form-external-jsf).

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.

We should migrate the example

Comment thread docs/documentation/user-guide/task-forms/jsf-task-forms.md Outdated
Comment thread docs/documentation/user-guide/logging.md Outdated
Comment thread docs/documentation/webapps/cockpit/extend/plugins.md Outdated
javahippie and others added 3 commits July 24, 2026 11:11
Resolve conflicts in favor of the PR's link updates, keeping newer
fixes from main (Operaton 1.x version example, backticked starter
artifact, relative Get Started link).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: Karsten Thoms <thoms@itemis.de>
Co-authored-by: Karsten Thoms <thoms@itemis.de>
javahippie and others added 5 commits July 24, 2026 11:24
Co-authored-by: Karsten Thoms <thoms@itemis.de>
…mcat.md

Co-authored-by: Karsten Thoms <thoms@itemis.de>
Co-authored-by: Karsten Thoms <thoms@itemis.de>
Co-authored-by: Karsten Thoms <thoms@itemis.de>
Co-authored-by: Karsten Thoms <thoms@itemis.de>
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.

3 participants