Hacker News Reader

For software projects I like markdown architectural decision records:

This is actually very similar in structure. With possible consequences, outcome, decision pros and cons