jakartaee / jakartaee/platform

Describe the Jakarta Transactions 2.1 read-only feature

Open
#1,201 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

EE12
Dominant language
No language data
Stars
230
Forks
77
Avg merge
8d 5h
Merged PRs (30d)
1

Description

**Is your feature request related to a problem? Please describe.**
https://github.com/jakartaee/platform/blob/main/specification/src/main/asciidoc/platform/TransactionManagement.adoc does not yet describe the [Transactions 2.1 read-only feature](https://github.com/jakartaee/transactions/issues/220).

**Describe the solution you'd like**
https://jakarta.ee/specifications/platform/11/jakarta-platform-spec-12.0#transaction-requirements should describe the Transactions 2.1 read-only feature as described in https://github.com/jakartaee/transactions/commit/a60daaa4e2231eb6f57ddf679e46455be5a18a15#diff-a7f1a8f7aa4fe67e98dd606d2752e6380bbc1d952dbd3e46907126923ba6125e and the final Jakarta Transactions 2.1 specification.

We need to explain how read-only transactions are expected to work in Jakarta EE 12+ applications so that users know how to use this new feature correctly.

**Describe alternatives you've considered**
none.

**Additional context**

https://www.eclipse.org/lists/messaging-dev/threads.html#00135 contains a Jakarta Messaging mailing list discussion about the Transactions read-only feature.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in specification/src/main/asciidoc/platform/TransactionManagement.adoc and locate the transaction-requirements section. Compare it with the Jakarta Transactions 2.1 specification, commit a60daaa4e2231eb6f57ddf679e46455be5a18a15, and the linked messaging-dev discussion. Done means the platform specification explains expected read-only transaction behavior for Jakarta EE 12+ applications.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.