Agreed and our tooling is heavily optimised towards writing code and testing it now, not reading it and testing it 2 years from now when you trace the code into

Agreed and our tooling is heavily optimised towards writing code and testing it now, not reading it and testing it 2 years from now when you trace the code into the briar patch. It drives me crazy that in my main editors/IDE's of choice I can't just hide all traces of comments when I'm writing code until I'm ready to comment it up or that I can't layer comments, since half the languages now have annotations for everything from documentation to configuration either built in or as add-on's. It's a lot of noise when you trying to grok just code and gets in the way.