Thread · 3 tweets · 8 Jul 2017

Yes. Not just for beginners, too. I've advocated for it a few times, but it's extra work and not normative so it rarely happens.

Also, when the text goes in it often seems obvious to those involved... who might forget not long later.

Back in ancient history, @timbray had made an annotated XML spec with that kind of information. It might be good to generalise that.