Experienced Devs

3956 readers

1 users here now

A community for discussion amongst professional software developers.

Posts should be relevant to those well into their careers.

For those looking to break into the industry, are hustling for their first job, or have just started their career and are looking for advice, check out:

Logo base by Delapouite under CC BY 3.0 with modifications to add a gradient

founded 1 year ago

MODERATORS

snowe@programming.dev

jmk1ng@programming.dev

drewsiferr@programming.dev

Documenting Architecture Decisions (cognitect.com)

submitted 1 year ago* (last edited 1 year ago) by canpolat@programming.dev to c/experienced_devs@programming.dev

20 comments fedilink hide all child comments

I wonder if there are others using ADRs for documenting their decisions.

you are viewing a single comment's thread
view the rest of the comments

[–] mattburkedev@programming.dev 2 points 1 year ago

I like them a lot. Sometimes I use it as an agenda to sell an idea in a meeting. Othertimes I backport them after a decision has been made. It’s the context that drives a decision that easily gets lost to time.

I’ve been burned when a technical decision hurt us down the road and no one could really remember why we made it to begin with.