Guide to the Jakarta EE Specification Process

Content

• Introduction
• Creation Review
• Plan Review
• Release Review
• Service Release
• Progress Review (optional)

Introduction

This guide is a step-by-step practical guide to help developers on Jakarta EE Specification projects to navigate the steps of the Jakarta EE Specification Process (JESP). It is meant as a helpful tool, so if in doubt, alway refer to the JESP for completeness. Please do not hesitate to contact the Specification Committee if you have any questions or comments about anything related to the development of Jakarta EE Specifications. JESP is an adoption of the Eclipse Specification Process (EFSP).

Creation Review

• A Jakarta Specification project is created as any other project under the Eclipse Development Process (EDP).
• A Jakarta Specification project must be approved by the Specification Committee.
• Read more about creation reviews in the EFSP.

Steps Involved

1. Create a Project Proposal (*).
2. Submit a Pull Request to the Jakarta EE Specifications repository using the creation review template.
3. Send an email to the Specification Committee to request a creation review.
4. Wait for a successful creation review before proceeding.

(*) It may be a good idea to socialize the idea with the Specification Committee to solicit support before proceeding with the project creation.

Plan Review

• Each specification project needs to engage in a Plan Review prior to any extensive development effort in support of a new Specification Major or Minor Version.
• Plan reviews are not required for Service Releases.
• Read more about plan reviews in the EFSP.

Steps Involved

1. Submit a Pull Request to the Jakarta EE Specifications repository using the plan review template.
2. Send an email to the Specification Committee to request a plan review.
3. Wait for a successful plan review before proceeding.

Release Review

• A final version of a specification cannot be made generally available until after engaging in a successful release review (with corresponding super-majority approval from the specification committee).
• Read more about release reviews in the EFSP.

Steps Involved

1. Submit a Pull Request to the Jakarta EE Specifications repository using the release review template.
2. Send an email to the Specification Committee to request a release review.
3. Wait for a successful release review before proceeding with the release.

Service Release

• There is no formal release review required for a Specification service release (x.y.z) as long as the JESP definition of a “service release” is adhered to.
• That means that no functionality changes or increase in IP scope are permitted in a service release.
• Read more about service releases in the EFSP as well as in the JESP.

Steps Involved

1. Submit a Pull Request to the Jakarta EE Specifications repository using the service release template.
2. Send an email to the Specification Committee to announce that the PR is ready for review.
3. Wait for the PR approval and merge before proceeding.

Progress Review

• Progress reviews are not part of the normal flow of the JESP: creation->plan->release->plan->release->plan->release and so on.
• A progress review can be initiated by the project when they want to inform the specification committee about their progress, but are not ready for a release yet.
• A progress review may be requested by the specification committee if no progress has been made in 12 months.
• Read more about progress reviews in the EFSP.

Steps Involved

1. Submit a Pull Request to the Jakarta EE Specifications repository using the progress review template.
2. Send an email to the Specification Committee to request a plan review.
3. Wait for a successful progress review before proceeding.