by CedricTeyton on 6/6/23, 8:19 AM with 1 comments
by turtleyacht on 6/6/23, 1:01 PM
This also means they are rarely updated. As tribal knowledge departs, ADRs become lonely artifacts of what was and could have been: unable to be kept current, they serve as faint guidance of a distant past.
One also does not want to be in the unenviable position of seeming to defend the old guard against the progress of new business initiatives that otherwise appear to shirk recommendations viewed as archaic or deprecated.
On the other hand, I love ADRs. They're the closest to RFCs for that category of documentation. Just that if the mind share (or sufficiently proper stick) is absent, folks will pretend not to read your links and just do their own thing anyway.
Maybe ADRs are best appropriate for startups, where documentation is sparse and people of influence can multiply mimetic exposure through docs.