10 Software Engineering Laws Everybody Loves to Ignore
A Twitter 🧵
A Twitter 🧵
1. Conway's Law
Also known as: "You will ship your org chart."
"Any organization that designs a system will produce a design whose structure is a copy of the organization's communication structure."
Also known as: "You will ship your org chart."
"Any organization that designs a system will produce a design whose structure is a copy of the organization's communication structure."
You may _think_ you can avoid it via cross-functional standup meetings and stakeholder updates and decision matrices, but eventually and inevitably conflicting or diverging priorities will lead to equally conflicting or divergent processes and outcomes.
2. Brooks's Law
From The Mythical Man-Month:
"Adding manpower to a late software project makes it later."
From The Mythical Man-Month:
"Adding manpower to a late software project makes it later."
When you realize you're not making the progress you thought you would and you're management tries to reallocate resources from another part of the org, you'll end up not only delaying the project, but you'll likely ship a more brittle, more complex product.
3. Zawinsky's Law
Adjusted for 2021:
"Every program attempts to expand until it includes a web server. Those programs which cannot so expand are replaced by ones which can."
Adjusted for 2021:
"Every program attempts to expand until it includes a web server. Those programs which cannot so expand are replaced by ones which can."
For web services, Zawinsky's Law becomes "...until it requires a user account and collects all users' data"; for physical devices, "...until it includes an insecure wifi access point with a default password you can't change. And a web server".
4. Parkinson's Law
"Work expands so as to fill the time available for its completion."
If you don't set a deadline, then the project will never be completed. This is why iterating on a minimum viable product within fixed timelines is important.
"Work expands so as to fill the time available for its completion."
If you don't set a deadline, then the project will never be completed. This is why iterating on a minimum viable product within fixed timelines is important.
5. Pareto's Fallacy
Pareto's Principle is easy to misinterpret, especially by management, often leading to Pareto's Fallacy:
"When you're 80% done, you think you only have 20% left."
The critical part that's overlooked here is that those 20% will require 80% of your time.
Pareto's Principle is easy to misinterpret, especially by management, often leading to Pareto's Fallacy:
"When you're 80% done, you think you only have 20% left."
The critical part that's overlooked here is that those 20% will require 80% of your time.
6. Sturgeon's Revelation
"90% of everything is crud."
Yes, that includes _your_ products.
"90% of everything is crud."
Yes, that includes _your_ products.
7. The Peter Principle
"In a hierarchy, every employee tends to rise to their level of incompetence. Thus, in time, every post tends to be occupied by an employee who is incompetent to carry out its duties."
Dunning and Kruger send their regards...
"In a hierarchy, every employee tends to rise to their level of incompetence. Thus, in time, every post tends to be occupied by an employee who is incompetent to carry out its duties."
Dunning and Kruger send their regards...
8. Eagleson's Law
"Any code of your own that you haven't looked at for six or more months might as well have been written by someone else."
6 months is rather optimistic.
"Any code of your own that you haven't looked at for six or more months might as well have been written by someone else."
6 months is rather optimistic.
One caveat to Eagleson's Law is the "Yo Momma Corollary": only the author is allowed to criticize the code; any other negative feedback is dismissed.
9. Greenspun's 10th Rule of Programming
Adjusted for authentication:
Adjusted for authentication:
https://twitter.com/jschauma/status/643444266300239873
This can be generalized to the Universal NIH-Rule: "any custom developed system contains an ad hoc, informally-specified, bug-ridden, slow implementation of half of the industry standard you refused to adopt".
10. The Iceberg Fallacy
"The cost of development of a new software product is the only ~25% of the total cost of ownership management sees and budgets for."
Ops Adage:
"The cost of development of a new software product is the only ~25% of the total cost of ownership management sees and budgets for."
Ops Adage:
https://twitter.com/jschauma/status/328865659536687105
11. The LGTM Dilemma
"If you want to quickly ship a 10 line code change, hide it in a 1500 line pull request."
Also known as The Bikeshedders' Blind Spot.
See also:
"If you want to quickly ship a 10 line code change, hide it in a 1500 line pull request."
Also known as The Bikeshedders' Blind Spot.
See also:
https://twitter.com/jschauma/status/1019410471999467525
...and off-by-one errors, of course. 🙃
• • •
Missing some Tweet in this thread? You can try to
force a refresh
