How should I document a technical decision?

Capture the context, options considered, decision, consequences, and review date. The record should explain why the decision was reasonable at the time, not just what was selected.