[Lwepz]

Splendid article.

I was thinking that perhaps walking the readers of our code through our architectural decisions(and not just through what our code does) is a good way to lessen their cognitive load. This helps identify decisions that have been taken to look smart or because the foie-gras the author ate on that day went down really well with the Chardonnay and made them feel extra stylish.

This also helps us understand how well we know the tools we're using versus how much we do simply through pattern repetition.