Notes on how things actually break.

Architecture, weird edge cases, and looking for the stuff they don't put in the docs.