I think the "keeping up to date" is a fools errand IMO. Because you end up with "half-up-to-date" documentation where someone thought to update some part of it,

I think the "keeping up to date" is a fools errand IMO. Because you end up with "half-up-to-date" documentation where someone thought to update some part of it, but not another. And it gets incoherent. So my preference is a coherent story at a point in time