Update external support links#153
Open
hauptmedia wants to merge 25 commits into
Open
Conversation
kthoms
requested changes
Jun 18, 2026
| @@ -30,8 +30,8 @@ The above workaround is not guaranteed to work for cases with bean references be | |||
|
|
|||
| The following test scenarios fail on Tomcat 10: | |||
Contributor
There was a problem hiding this comment.
Suggested change
| The following test scenarios fail on Tomcat 10: | |
| The following test scenarios fail on Tomcat 11: |
|
|
||
| * [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) |
Contributor
There was a problem hiding this comment.
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). |
Contributor
There was a problem hiding this comment.
These libraries are still in use by the old webapps. Please leave this section and just remove the "Starting with..." statement.
| * [AngularJS](https://angularjs.org) | ||
| * [RequireJS](https://requirejs.org) | ||
| * [jQuery](https://jquery.com) | ||
| * [Twitter Bootstrap](https://getbootstrap.com) |
Contributor
There was a problem hiding this comment.
I'd remove "Twitter"
Suggested change
| * [Twitter Bootstrap](https://getbootstrap.com) | |
| * [Bootstrap](https://getbootstrap.com) |
|
|
||
| The REST API provides some resources in an additional media type. The | ||
| [HAL](http://stateless.co/hal_specification.html) media type `application/hal+json` describes a format which contains | ||
| [HAL](https://datatracker.ietf.org/doc/html/draft-kelly-json-hal-08) media type `application/hal+json` describes a format which contains |
Contributor
There was a problem hiding this comment.
Suggested change
| [HAL](https://datatracker.ietf.org/doc/html/draft-kelly-json-hal-08) media type `application/hal+json` describes a format which contains | |
| [HAL](https://www.ietf.org/archive/id/draft-kelly-json-hal-11.html) media type `application/hal+json` describes a format which contains |
Contributor
There was a problem hiding this comment.
I have also raised a discussion at https://forum.operaton.org/t/drop-hal-support/432
| ## JNDI Bindings | ||
|
|
||
| To use the JNDI Bindings for Operaton Services on Apache Tomcat you have to add the file `META-INF/context.xml` to your process application and add the following ResourceLinks ([Tomcat 9](http://tomcat.apache.org/tomcat-9.0-doc/config/context.html#Resource_Links), [Tomcat 10.1](https://tomcat.apache.org/tomcat-10.1-doc/config/context.html#Resource_Links)): | ||
| To use the JNDI Bindings for Operaton Services on Apache Tomcat you have to add the file `META-INF/context.xml` to your process application and add the following ResourceLinks ([Tomcat 9](https://tomcat.apache.org/tomcat-9.0-doc/config/context.html#Resource_Links), [Tomcat 10.1](https://tomcat.apache.org/tomcat-10.1-doc/config/context.html#Resource_Links)): |
Contributor
There was a problem hiding this comment.
Suggested change
| To use the JNDI Bindings for Operaton Services on Apache Tomcat you have to add the file `META-INF/context.xml` to your process application and add the following ResourceLinks ([Tomcat 9](https://tomcat.apache.org/tomcat-9.0-doc/config/context.html#Resource_Links), [Tomcat 10.1](https://tomcat.apache.org/tomcat-10.1-doc/config/context.html#Resource_Links)): | |
| To use the JNDI Bindings for Operaton Services on Apache Tomcat you have to add the file `META-INF/context.xml` to your process application and add the following [ResourceLinks](https://tomcat.apache.org/tomcat-11.0-doc/config/context.html#Resource_Links): |
| 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). |
Contributor
There was a problem hiding this comment.
We should migrate the example
| ## Styling your Task Forms | ||
|
|
||
| We use [Twitter Bootstrap](http://getbootstrap.com/) in our tasklist - so best add this to your Process Application as well and you can easily polish your UI: | ||
| We use [Twitter Bootstrap](https://getbootstrap.com/) in our tasklist - so best add this to your Process Application as well and you can easily polish your UI: |
Contributor
There was a problem hiding this comment.
Suggested change
| We use [Twitter Bootstrap](https://getbootstrap.com/) in our tasklist - so best add this to your Process Application as well and you can easily polish your UI: | |
| We use [Bootstrap](https://getbootstrap.com/) in our tasklist - so best add this to your Process Application as well and you can easily polish your UI: |
| ``` | ||
|
|
||
| Find more information for Diagnosing the Job Executor in this blog post - [The Job Executor: What Is Going on in My Process Engine?](https://blog.camunda.com/post/2019/10/job-executor-what-is-going-on-in-my-process-engine/). | ||
| For more background on job acquisition and execution, see [The Job Executor](process-engine/the-job-executor.md). |
Contributor
There was a problem hiding this comment.
Suggested change
| For more background on job acquisition and execution, see [The Job Executor](process-engine/the-job-executor.md). | |
| Find more information for Diagnosing the Job Executor in this blog post - [The Job Executor: What Is Going on in My Process Engine?](https://camunda.com/blog/2019/10/job-executor-what-is-going-on-in-my-process-engine/. |
| Please note that all Plugins with this prefix will be included using the 7.13 plugin mechanism. You cannot create new Plugins with IDs starting with `legacy`. | ||
|
|
||
| For more details about legacy Plugins, check out the legacy [Plugin documentation](https://docs.operaton.org/docs/documentation/webapps/cockpit/extend/plugins/). Please note that this link will take you to the documentation of Operaton. | ||
| For more details about legacy Plugins, see the plugin points below. |
Contributor
There was a problem hiding this comment.
Suggested change
| For more details about legacy Plugins, see the plugin points below. | |
| For more details about legacy Plugins, check out the legacy [Plugin documentation](https://docs.operaton.org/docs/documentation/webapps/cockpit/extend/plugins/). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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-platformGitHub repository links to the currentoperaton/operatonrepositoryupdate stale
operaton/operatonGitHub links frommastertomainwhere the current targets existupdate dead
operaton-bpm-exampleslinks to the currentoperaton/operaton-examplescatalog where matching examples existremove 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.jsrepository entryuse HTTPS for Tomcat home and Tomcat 9 Resource Links references in the Tomcat installation/integration pages
replace the old external
operaton.org/downloadWildFly subsystem note with the local full-distribution download documentation linkreplace 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-jsr223repository referencesreplace dead webapp translations repository links with current Admin, Cockpit, and Tasklist locale directories in
operaton/operatonreplace stale standalone Forms SDK Bower distribution links with the current SDK source tree in
operaton/operatonand clarify that no separate Operaton Bower release repository is publishedreplace the dead standalone
operaton-dmn-modelrepository link with the local DMN Model API documentationreplace stale public
docs.operaton.org/docs/documentation/...self-links in Security and Cockpit plugin docs with local documentation references or inline wordingupdate 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 -Sreturns no matchesrg -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 -Sreturns no matchescurl -L -o /dev/null -sS --max-time 20 -w "%{http_code}"returned200for the replacement Rhino, Nashorn, Jackson 2.10, and Spring Boot application-properties targetsrg -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 -Sreturns no matchesDmnEngine.htmlandDecisionService.htmlJavadocs and confirmed the replacement method idsevaluateDecisionTable(org.operaton.bpm.dmn.engine.DmnDecision,java.util.Map)andevaluateDecisionTableByKey(java.lang.String)existrg -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 -Sreturns no matchescurl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" https://docs.oracle.com/javase/8/docs/api/returns200; the removed BPM Guide URL now redirects to the Camunda homepage instead of the original articlerg -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> -Sfinds no matchescurl -L -o /dev/null -sS --max-time 20 -w "%{http_code}"returned200for 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 targetsrg -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 -Srg -n "camunda\\.com|blog\\.camunda|docs\\.camunda|app\\.camunda|github\\.com/camunda" <updated files> -Sfinds no matchesrg -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 -Sfinds no matches for malformed markdown or stale OWASP targetsrg -n "access\\.redhat\\.com|Model Refernce" docs/documentation/user-guide/security.md -Sfinds no matchescurl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" https://cheatsheetseries.owasp.org/cheatsheets/XML_External_Entity_Prevention_Cheat_Sheet.htmlreturns200rg -n "http://(www\\.slf4j\\.org|logging\\.apache\\.org|logback\\.qos\\.ch)" docs/documentation/user-guide/logging.md -Sfinds no matchesrg -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 -Sfinds no matchesrg -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 -Sfinds no matchesrg -n "operaton-bpm-examples|github\\.com/operaton/operaton/(tree|blob)/master" docs -Sfinds no matchesrg -n "http://tomcat\\.apache\\.org" docs/documentation/installation/full/tomcat/index.md docs/documentation/user-guide/runtime-container-integration/tomcat.md -Sfinds no matchesrg -n "operaton\\.org/download" docs/documentation/user-guide/runtime-container-integration/jboss.md -Sfinds no matchesrg -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 -Sfinds no matcheschecked 121 urls across 32 files; problematic 0rg -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> -Sfinds no matchescurl -L -o /dev/null -sS --max-time 20 -w "%{http_code}"returned200for the updated Operaton, GitHub, OWASP, Red Hat, logging, examples, Tomcat, WildFly, IronJacamar, FreeMarker, Velocity, bpmn.io, MyBatis, Moment, Less, Bootstrap, Jakarta REST, and Javadocs targetscurl -s -o /dev/null -w "%{http_code}" -L https://tomcat.apache.org/andcurl -s -o /dev/null -w "%{http_code}" -L https://tomcat.apache.org/tomcat-9.0-doc/config/context.html#Resource_Linksreturn200gh repo view operaton/bower-operaton-bpm-sdk-jsconfirms the old standalone Forms SDK Bower release repository is not published under Operatonnpm view operaton-bpm-sdk-jsandnpm view @operaton/bpm-sdk-jsreturn 404, so the docs no longer claim an npm/Bower package install pathcurl -L -o /dev/null -sS --max-time 20 -w "%{http_code}" https://github.com/operaton/operaton/tree/main/webapps/frontend/operaton-bpm-sdk-jsreturns200curl -L -o /dev/null -sS --max-time 20 -w "%{http_code}"returns200forhttps://www.wildfly.org/,https://mybatis.org/mybatis-3/,https://www.slf4j.org/,https://www.slf4j.org/manual.html, andhttps://logback.qos.ch/gh repo view operaton/operaton-dmn-modelconfirms the old standalone DMN model repository is not published under Operaton;npm run buildvalidates the replacement local../model-api/dmn-model-api/documentation linkrg -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 -Sfinds no matchesrg -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 -Sfinds no matchesnpm run buildvalidates the replacement relative Tomcat manual link in the Security guiderg -n "http://angularjs\.org|http://requirejs\.org|http://jquery\.com|http://en\.wikipedia\.org/wiki/Command_pattern" docs/documentation/introduction/architecture.md -Sfinds no matchescurl -L -s -o /dev/null -w "%{http_code}"returns200forhttps://en.wikipedia.org/wiki/Command_pattern,https://angularjs.org,https://requirejs.org, andhttps://jquery.comgit diff --checknpm run typechecknpm run buildsucceeds; Docusaurus still reports pre-existing broken link/anchor warnings outside this PR