Exactly, same here. I'll add a small amount of documentation to the actual code with a reference to a #Gotchas header or equivalent in the readme with verbose d

Exactly, same here. I'll add a small amount of documentation to the actual code with a reference to a #Gotchas header or equivalent in the readme with verbose detail. Some times design decisions aren't immediately obvious but should be explained for both future colleagues and you.