> At best they record the intent of an author at some unknown point in the past.

This probably says something about the priority the teams you worked with put on documentation. Write once and never update?