Skip to content

fix(doc): Fix broken external links (#215) - #230

Merged
kthoms merged 8 commits into
mainfrom
fix/broken-external-links-215
Nov 4, 2026
Merged

kthoms merged 8 commits into
mainfrom
fix/broken-external-links-215

Conversation

@kthoms

@kthoms kthoms commented Nov 4, 2026

Copy link
Copy Markdown
Contributor

Fixes the 404 external links reported in #215.

  • BPMN reference/tutorial and DMN tutorial links now point to camunda.com (anchors preserved); the Drools consulting demo bullet is removed
  • Extensions page rewritten around the Operaton Hub; extensions live in their own repositories
  • Maven archetypes page replaced by Operaton Starter (the archetypes and repo do not exist); referring pages reworded
  • Removed the testing libraries section (no Operaton forks of assert-scenario / process-test-coverage)
  • FEEL data types link updated to docs.camunda.io
  • Removed dead IronJacamar links

The Camunda Modeler blog link from the issue was already gone from deploy.md.

Closes #215 once the next link check is clean.

🤖 Generated with Claude Code

kthoms and others added 6 commits November 4, 2026 04:49
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings November 4, 2026 03:49

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.

🟡 Changes recommended

The Starter guidance allows readers to skip manual setup that remains necessary for the Java EE and servlet tutorials, leaving required dependencies, configuration, and application classes missing for deployment.

2 open issues
What changed in this PR

This documentation-only PR addresses broken external links reported in #215 and replaces obsolete project-template and community-extension guidance.

Changes:

  • Redirect BPMN, DMN, and FEEL references to Camunda resources.
  • Replace Maven archetype guidance with Operaton Starter and community-extension guidance with Operaton Hub.
  • Remove unavailable testing-library, Drools demo, and IronJacamar references.
File Description
docs/​get-started/​dmn/​project-setup.md Point project-generation guidance to Starter.
docs/​get-started/​archive/​javaee7/​project-setup.md Replace archetype recommendation with Starter.
docs/​get-started/​archive/​java-process-app/​project-setup.md Replace archetype recommendation with Starter.
docs/​documentation/​user-guide/​testing/​index.md Reference Starter and remove unavailable testing extensions.
docs/​documentation/​user-guide/​process-engine/​process-engine-concepts.md Update BPMN learning links.
docs/​documentation/​user-guide/​process-applications/​the-process-application-class.md Replace archetype references with Starter.
docs/​documentation/​user-guide/​process-applications/​maven-archetypes.md Document Starter project types and generation interfaces.
docs/​documentation/​user-guide/​dmn-engine/​feel/​spin-integration.md Update FEEL data-types link.
docs/​documentation/​user-guide/​dmn-engine/​feel/​custom-functions.md Update FEEL data-types link.
docs/​documentation/​reference/​bpmn20/​tasks/​task-markers.md Update task reference links.
docs/​documentation/​reference/​bpmn20/​tasks/​service-task.md Update task reference links.
docs/​documentation/​reference/​bpmn20/​tasks/​receive-task.md Update task reference links.
docs/​documentation/​reference/​bpmn20/​tasks/​business-rule-task.md Update task links and remove unavailable Drools demo.
docs/​documentation/​reference/​bpmn20/​subprocesses/​event-subprocess.md Update event subprocess reference links.
docs/​documentation/​reference/​bpmn20/​subprocesses/​embedded-subprocess.md Update subprocess reference links.
docs/​documentation/​reference/​bpmn20/​subprocesses/​call-activity.md Update call activity reference links.
docs/​documentation/​reference/​bpmn20/​index.md Update BPMN tutorial and event reference links.
docs/​documentation/​reference/​bpmn20/​gateways/​parallel-gateway.md Update parallel gateway reference links.
docs/​documentation/​reference/​bpmn20/​gateways/​inclusive-gateway.md Update inclusive gateway reference links.
docs/​documentation/​reference/​bpmn20/​gateways/​exclusive-gateway.md Update exclusive gateway reference links.
docs/​documentation/​reference/​bpmn20/​gateways/​event-based-gateway.md Update event-based gateway reference links.
docs/​documentation/​reference/​bpmn20/​events/​terminate-event.md Update terminate event reference links.
docs/​documentation/​reference/​bpmn20/​events/​signal-events.md Update signal event reference links.
docs/​documentation/​reference/​bpmn20/​events/​error-events.md Update error event reference links.
docs/​documentation/​reference/​bpmn20/​events/​conditional-events.md Update conditional event reference links.
docs/​documentation/​reference/​bpmn20/​events/​cancel-and-compensation-events.md Update compensation event reference links.
docs/​documentation/​introduction/​implemented-standards.md Update BPMN and DMN learning links.
docs/​documentation/​introduction/​extensions.md Explain Hub discovery, submissions, and compatibility.
docs/​documentation/​installation/​full/​wildfly/​manual.md Remove dead IronJacamar database links.
docs/​documentation/​index.md Link community-extension discovery to Operaton Hub.

Review effort: Balanced

Comment thread docs/get-started/dmn/project-setup.md Resolved
kthoms and others added 2 commits November 4, 2026 05:01
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Operaton Starter does not generate the servlet WAR or Java EE projects
these tutorials build by hand.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@kthoms
kthoms merged commit e103ce1 into main Nov 4, 2026
3 checks passed
@kthoms
kthoms deleted the fix/broken-external-links-215 branch November 4, 2026 04:12
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: Docs, external: not found (404/410)

2 participants