This is absolutely my second system, and one often preferred over my ... um... preferred system :D. In other words, I have my personal bias, but this approach is far easier to scale with a team over time.
I still tend to keep the "HACKS" thing though, simply because they localize the documentation right where you need to be aware of it.
I still tend to keep the "HACKS" thing though, simply because they localize the documentation right where you need to be aware of it.