Ruth — of systems & design

@RuthMalan
3K Followers
2.9K Following
16.4K Posts

Software And Systems Architecture, more or less

Profile pic: drawing of me (gifted to me); upside down, as if in a reflection, with cloudy sky and little architecture drawing character hanging from frame

Webhttps://www.ruthmalan.com
Classeshttps://ti.to/bredemeyer/

“ADRs are short documents that capture a decision, structured into logs that reveal a history of architectural thinking for a product”

— Martin Fowler

https://www.linkedin.com/posts/martin-fowler-com_adrs-are-short-documents-that-capture-a-decision-share-7442232936789213184-oUSA

bliki: Architecture Decision Record | Martin Fowler | 61 comments

ADRs are short documents that capture a decision, structured into logs that reveal a history of architectural thinking for a product https://lnkd.in/e9K7VHDE | 61 comments on LinkedIn

LinkedIn
The post refers to Nygard’s 2011 “Document Architecture Decisions” post — which wasn’t the first to present a decision template (e.g., “Architecture Decisions: Demystifying Architecture,” by Jeff Tyree and Art Ackerman was published in IEEE Software in 2005), but it was the post that really had impact.

“ADRs contain not just the decision, but also a brief rationale for the decision. This should summarize the problem that led to this decision being needed and the trade-offs that were taken into account. A good way to think of them follows the notion of “forces” when writing a pattern.”

https://martinfowler.com/bliki/ArchitectureDecisionRecord.html

bliki: Architecture Decision Record

A short document that captures a single decision, structured into a log to provide a history

martinfowler.com

“A general rule is to follow an “inverted pyramid” style of writing, commonly associated with news stories. The key is to put the most important material at the start, and push details to later in the record.”

https://toot.thoughtworks.com/@mfowler/116284886338044351

Martin Fowler (@[email protected])

NEW POST ADRs are short documents that capture a decision, structured into logs that reveal a history of architectural thinking for a product https://martinfowler.com/bliki/ArchitectureDecisionRecord.html

Thoughtworks’ Mastodon instance

Catching up on Tessa Violet's latest

AND Y"ALL

Tessa is wearing a Copeland James' Small Talk t-shirt at one point (~ minute 2:30) in the "I Love Being Wrong" music video!

(The video is a collection of informal clips, so it's just what she was wearing at some captured moment, and that's extra sweet and cool.)

https://www.youtube.com/watch?v=Cm8ur04E9cY

Tessa Violet - I Love Being Wrong (official music video)

YouTube

RE: https://mastodon.social/@impactology/116290362087384719

The responsibility shed:

“We have basically given up all discipline and agency for a sort of addiction, where your highest goal is to produce the largest amount of code in the shortest amount of time. Consequences be damned.”

this is quintessential @romeu / @Cyriux and I'm still smiling

https://mastodon.social/@romeu/116262659792160727

I used "different than" and then wondered what a pendant might say, so looked it up, and... that was more fun than I expected (haha):

https://www.merriam-webster.com/grammar/different-from-or-different-than

Should it be 'different from' or 'different than'?

Or is it 'Different to'?

But also… we might consider how we use “opinions”…

Like, I have insights, observations, experience, but you! You have opinions.

jk jk I have opinions. You have insights.

But seriously though. “Opinions” is loaded. And that’s ok, if I’m reminding myself to be humble, to seek to verify, to probe and test.

RE: https://mastodon.social/@RuthMalan/116264382437929097

No Technical Leadership alum this time (but someone bringing lessons over from the last System Design cohort, so that's cool)...

Given everything, it's just amazing to have several lovely folk from here (waves at @joannalaine and others) and others from LI, joining us ... TOMORROW and next week :)

Still some space.