Design Diagrams
Generally it's best to encapsulate design decisions in code by writing simple code and if that's not possible, writing useful comments. But sometimes you need a picture. So this is a place to capture design artifacts that don't make sense to have in code.
Our power management (in Misc/PowerManager.cpp) is fairly complex. I drew a picture to try to hold it in my brain:
