And with diagrams as text close to the code chances are they will be kept to up to date (and created to begin with…).

the interesting thing here is that there are comments that say which concern depends on which.