doc: Add some header comments to provide design rationale.

I forgot why this was there until I looked back at the commit logs.
Thanks for providing a good log message :)