...

The Compatibility section of a proposal should indicate whether the changes may require a new major version, indicating a change that breaks such as breaking backward compatibility with public interfaces. Breaking compatibility may highlight the need to introduce a migration strategy.

The Description section contains the substantive details of the changesa substantive implementation strategy. The description should be detailed enough to understand the general implementation approachcore components, configuration properties, and integration points involved. Details may include interface definitions, pseudo code, or diagrams as necessary, depending on the complexity of the proposal.

...

The Alternatives section is important as it relates to scope and compatibility considerations. Describing other approaches helps to avoid unnecessary reconsideration in the future, and also shows adequate attention given to the positives and negatives of various approaches.

Review Platform

Apache Jira provides self-service issue handling to support proposal review. NiFi Improvement Proposals have a separate Jira Project Key for identification and linking.

Jira issue comments support discussion of the proposal, and issue status indicates the intermediate or final status of a proposal.

...