Skip to main content

Content

Introduction

This article is a self-contained, step-by-step, practical guide to help developers navigate the Jakarta EE Specification Process (JESP).

It is meant as a helpful tool, so if in doubt, always refer to the JESP for completeness. Contact the Specification Committee if you have any questions or comments about anything related to the development of Jakarta EE Specifications. The JESP is an adaptation of the Eclipse Foundation Specification Process (EFSP), which is itself an adaptation of the Eclipse Foundation Development Process (EDP).

This diagram is the Eclipse Specification Version Lifecycle. It shows the steps to create and evolve a Specification.

Eclipse Release Cycle

The most important kind of step in the lifecycle is the Review step. A Review is an event that takes place over a week or two of calendar time. The team developing a Specification creates some kind of artifact and submits it to the Specification Committee for review. The Specifiation Committee has a short amount of time to review the submitted artifact and conduct a ballot among its members to approve or not-approve that artifact under review. This guide contains a sufficient explanation of Review, but if you want the full definition, see the Eclipse Foundation Specification Process and the Eclipse Foundation Development Process.

The remainder of this guide explains the different kinds of Review steps, and the steps you need to take for each one.

Creation Review

Creation Review

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

Plan Review

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

Release Review

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

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 Review

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.

Back to the top