I agree with this, and that's how I do it.

I don't think we are at a position to claim that documentation are the source, though to your point and the author's point as well, it serving more purpose now then what used to have.

I would say that this field is evolving really fast and we might consider and revise some practices. So I try to keep as much as open mind as possible.