Template
Short summary and and relevant context
Goals
What was the purpose?
Design Decisions
What choices were made? Why?
Historical Context
Legacy code, compatibility/concerns?
Technical Constraints
Infeasible or impossible goals? Limitations and other technical considerations?
Trade-Offs
Pros/cons, weighed arguments, conclusions?
Evaluation
Does this design meet all the requirements? Is it the simplest possible design given all of the above?
Alternatives
Different approaches that were considered/not considered, (dis)advantages, matter of style?
See also
- Link to tutorial
- Link to how-to guides
- Link to references