[dglass]

I started a new job about two months ago and completely agree. The ADRs and Feature Specs have been immensely helpful in getting context around why certain decisions were made and the tradeoffs considered when making decisions.

It's especially useful because I joined the team during Covid and haven't actually met anyone else in person yet. I can't just turn around in my chair and ask someone at the desk next to me why something is the way it is. Now it involves pinging someone, setting up a zoom call, etc.

[zimpenfish]

I joined a place recently and there was zero documentation, zero ADRs, zero discussions logged except vaguely in Slack, etc. Consequently I was completely baffled about why everything was as it is for the first few months ("Where do I find a network?" "It's in the frobnob_stash table under 'lemon'." "Oh, yeah, OBVIOUSLY.")