HN Hall of Fame Weekly email

Hyrum's Law

www.hyrumslaw.com Essays & writing Essays & articles Software engineering Candidate
Screenshot of www.hyrumslaw.com captured 2026-07-20
Page preview · captured 2026-07-20

Resurfaced independently across 7 calendar years, with breakout response in 3 of them.

submissions
12
submitters
11
observed span
2018–2025
peak thread · 66 comments
146 pts
latest 20+ return · 2025-08-01
112 pts

Submission timeline

2007–2026

One slot for every year since HN launched. Height is that year's peak points; orange marks a 100+ point or 50+ comment breakout. Select a bar to open its strongest thread.

First comments on top threads

HN comment order

One approach to guard against Hyrum’s Law is GREASE (aka “Generate Random Extensions And Sustain Extensibility” used in the TLS 1.3 protocol) i.e. behavior randomization to avoid inadvertent dependencies on unspecified behavior: https://textslashplain.com/2020/05/18/a-bit-of-grease-keeps-... What are other approaches?

This is an argument for maintainers to routinely change any unspecified behavior that doesn't cost (much) more to do it the new way, on each release. In a hash, tweak the hash function. Downstream dependents breaking because they depend on undocumented behavior is their fault, not your fault. The sooner they break, the less it costs.

ncmncm·125-point thread·

There's a corollary: Even if you explicitly deny a guarantee of a certain behavior in your contract, if you usually deliver that behavior, most of your customers will depend on it. Some examples: If you make a queueing system, it's impossible to guarantee anything other than delivery "at most once" (some loss occurs), or "at least once" (some duplication occurs), but if you usually provide "exactly once" in practice, most of your customers will depend on this. If you provide…

avidiax·112-point thread·

I see Hyrum's Law as the highlighting a problem with the robustness principle. You start with: We followed the robustness principle, which is be conservative in what you do and be liberal in what you accept from others But then, the 'things you accept' become part of your api: The problem with the robustness principle is a flaw can become entrenched as the defacto standard. Any implementation of a protocol is required to replicate the apparent behavior. This is both…

The first top-level comment from each of the four biggest threads, in HN’s own order. Excerpts are shortened; open a comment for full context.

Breakout years
3

100+ points or 50+ comments

Total points
518

reference only — not used in Hall rules or ranking

Total comments
232

reference only — not used in Hall rules or ranking

Every submission

DateTitle as submittedByPointsComments
2018-02-20Hyrum's Lawmooreds10
2018-02-25Hyrum's Lawingve20
2018-06-19Hyrum's Lawwheresvic110
2019-02-25Hyrum's LawBerislavLopac21
2019-04-07Hyrum's Lawshawndumas10
2019-11-12Hyrum's Law: An Observation on Software Engineeringhappy-go-lucky286
2020-03-18Hyrum's Laweindiran30
2021-06-03Hyrum's Lawtosh245
2022-01-08Hyrum's LawFirst breakouteindiran12536
2022-10-21Hyrum's Lawpmoriarty7353
2024-02-16Hyrum's LawBest threadnvahalik14666
2025-08-01Hyrum's LawLatest 20+ point returnandsoitis11265