[kthoms]

Summary

Documents an internal API change in the 2.2 release notes that was missing, as promised in operaton/operaton#4038 (comment).

Since 2.2 (operaton/operaton#3550), Context.getProcessEngineConfiguration() and Context.getCommandContext() throw an IllegalStateException instead of returning null when no engine command is active on the current thread.

Changes in release-notes/2_2/index.md:

• New section under Removed & Changed APIs describing the change, the exception messages, and the new findProcessEngineConfiguration() / hasActiveProcessEngineConfiguration() / findCommandContext() / hasActiveCommandContext() methods, with a migration example
• Recommendation to use public service APIs (RuntimeService, DelegateExecution, ...) instead of internal Context
• Warning box on internal .impl. packages
• Nullability Declarations section no longer calls the effort "non-breaking" and links to the new section

Open point

The warning box states plans for 2.3 (explicit declaration of internal packages, stricter enforcement). Please confirm or drop before merging.

Test plan

• npm run build succeeds; no broken links/anchors reported for release notes pages
• #context-null-safety anchor renders

🤖 Generated with Claude Code

[Copilot]

🔵 Needs a closer look

A maintainer must confirm or remove the unverified Operaton 2.3 commitment to internal-package declarations and stricter enforcement before publication.

No open issues 🎉

What changed in this PR

Documents the internal Context null-safety change in Operaton 2.2 and provides migration guidance for applications that previously relied on nullable getters.

Changes:

• Describes the new exceptions, optional-returning alternatives, and context-presence checks.
• Adds migration examples, recommends public APIs, and warns about internal API stability.
• Updates the nullability section to acknowledge the behavior change and link to the new guidance.

File	Description
docs/​documentation/​reference/​release-notes/​2_2/​index.md	Adds Context migration guidance and internal API warnings; corrects the nullability overview.

_{Review effort: Balanced}