Annotate the decisions

[wolfie]

There's a lot of files and configs. It'd be nice to be able to somehow easily annotate what each bit does, and why it's needed.