Summary

Short explanation of the feature.

Rationale

Why should we do this?

Design

An dense explanation in sufficient detail that someone familiar with the project could implement the feature. Specifics and corner cases should be covered.

Examples

Illustrations and examples to clarify descriptions from previous sections.

Drawbacks

What are the negative trade-offs?

Alternatives

What other solutions have been considered?

Unresolved Questions

What parts of problem space or proposed designs are unknown or TBD?