Top all-time · #17029
Bruno Scheufler
Personal blog · brunoscheufler.com/blog · on HN as brunoscheuflerprogrammingsystemsstartups
Bruno Scheufler's personal blog at brunoscheufler.com covers programming, systems and startups. Since 2022, 4 different Hacker News readers have linked it 5 times, most often “Documenting Design Decisions Using RFCs and ADRs (2020)”. It is still writing: the last post was on 2026-07-05, and you can follow it by feed.
Too few sampled comments (1) to say how often HN recommends it.?
Why HN links it
HN readers link this post on why code isn't self-documenting, covering the documentation triangle. The one comment cites it while arguing that code review helps keep documentation valuable.
Summarised by Claude from a sample of 1 HN comments that link here. Each comment is marked recommending, critical or neutral (citing without judging); how this works.
building startups and distributed systems. Click to read Bruno Scheufler on Substack. Launched 2 months ago.
Most-linked posts?
- Documenting Design Decisions Using RFCs and ADRs (2020)2 people · 2 mentions · first linked 2022-05-30
What Hacker News says?
Like TFA suggests, right at the end, this is where code review shines. Keeping documentation valuable is a discipline challenge, and we all fail from time to time at keeping ourselves disciplined. If you have team agreement on the level of documentation that gives good ROI for time spent maintaining it, you can rely on your team to help catch your slips just as they can rely on you to help catch theirs. Using someth…
Comment linking /blog/2020-07-04-documenting-design-decisions-using-rfcs-and-adrs
on “The Documentation Triangle, or, why code isn't self documenting”Submitted Documenting Design Decisions Using RFCs and ADRs (2020) as a story · 66 points
HN discussionSubmitted Steady State Means Continuous Rewriting as a story · 15 points
HN discussionSubmitted Making Architects Work in Software Teams as a story · 4 points
HN discussionSubmitted Modeling Polymorphic Relations in Postgres as a story · 1 points
HN discussion