Leanpub Header

Skip to main content

The Software Developer's Common Sense

Principles, Judgment, and the Craft of Building Software That Lasts

The Software Developer's Common Sense
This book is 100% completeLast updated on 2026-09-04

Good software is not about following rules. It is about knowing when they apply. This book explores the judgment behind building software that lasts, from choosing simplicity over cleverness to balancing today’s needs with tomorrow’s costs. Practical, thoughtful and focused on decisions, not dogma.

Minimum price

$19.00

$29.00

You pay

Author earns

$

Also available for 1 book credit with a Reader Membership

PDF
EPUB
WEB
APP
116
Pages
About

About

About the Book

Software is full of rules that are right in one context and wrong in another. A feature that is brilliant in a weekend prototype can be a disaster in a decade old banking system, and the same code that thrives in a two person team can rot in a two hundred person organization. The difference between the two is rarely talent. It is judgment. This book teaches the reasoning that experienced developers use when they make those calls: how to trade off simplicity against power, how to think in cost over time, how to recognize when a principle stops applying, and how to build systems that are reliable, maintainable, secure, and easy to change. It is not a list of best practices and it does not tell you which tool to pick. It gives you the durable principles, the mental models, and the practical habits that let you decide for yourself, and the confidence to know why your decision was the right one in that particular situation.

Author

About the Author

Steve Publications

Steve is a technology professional with more than 20 years of experience in software development, server infrastructure, cybersecurity, vulnerability research and reverse engineering. Throughout his career, he has designed, secured, analyzed and tested complex software and infrastructure, with a particular focus on understanding how systems fail and how they can be made more secure.

Outside of work, Steve enjoys sharing knowledge with the technology community. He collaborates with researchers, industry experts and technology professionals to write practical books covering software development, cybersecurity, cloud computing, networking, DevOps, artificial intelligence and enterprise technologies. His books focus on practical learning through clear explanations, real-world examples and hands-on exercises. With more than two decades of industry experience, his goal is to help IT professionals, students and technology enthusiasts build useful skills and stay current in a rapidly changing industry.

We believe readers deserve to know how our books are created. Most of our authors are not native English speakers, so we use AI to help translate, proofread manuscripts, fix grammar, improve sentence structure and make technical explanations easier to read. AI is used as an editing tool only. It does not replace the research, technical knowledge or hands-on experience behind our books. Some of our authors also prefer to remain anonymous for privacy or professional reasons. In those cases, we publish their work under a different name. The author's name may be different, but the quality of the content and our review process remain the same.

Every book is written, reviewed and maintained by experienced technology professionals, with contributions from our private technical community of more than 420 engineers and researchers. We spend far more time validating technical accuracy and keeping our content up to date than generating text. We are always interested in working with experienced professionals who have deep expertise in a particular technology or domain. If you would like to publish a book with us or help review an existing manuscript, we'd love to hear from you. Send us a message describing your area of expertise. We are especially interested in niche technologies, specialized skills and emerging topics that are underrepresented in existing technical literature.

If you look through the contents of our books, you'll see practical examples, detailed explanations and material that is regularly updated. Our goal is to publish books that professionals can actually rely on, not low-effort AI-generated content. If you ever feel that one of our books does not meet that standard, Leanpub offers a 60-day money-back guarantee. Feel free to request a refund if you are not satisfied with your purchase.

Contents

Table of Contents

Principles, Judgment, and the Craft of Building Software That Lasts

Introduction: The Case for Common Sense

  1. A Bug That Cost Millions
  2. What Common Sense Is (and Is Not)
  3. The Five Questions Experienced Developers Ask
  4. How to Use This Book

Chapter 1: The Common-Sense Mindset

  1. Two Kinds of Complexity
  2. Judgments, Not Rules
  3. One-Way Doors and Two-Way Doors
  4. Cost Over Time
  5. Knowing What You Don’t Know

Chapter 2: Problems, Requirements, and Change

  1. The Real Problem Is Rarely the Stated Problem
  2. Eliciting and Expressing Requirements
  3. Scope, YAGNI, and the Planning Dilemma
  4. Estimation and Prioritization as Reasoning

Chapter 3: Simplicity

  1. The Compounding Cost of Complexity
  2. What Simple Actually Means
  3. Techniques for Staying Simple
  4. When to Complicate on Purpose

Chapter 4: Code Quality and Readability

  1. Code Is Read More Than It Is Written
  2. Naming and Local Clarity
  3. Small Functions and Flat Control Flow
  4. The Same Logic, Three Ways

Chapter 5: Structure, Abstraction, Modularity, Coupling, and Cohesion

  1. Why We Abstract, and What It Costs
  2. Modules and Single Responsibility
  3. Deep Modules and Information Hiding
  4. Coupling, Cohesion, and the Direction of Dependence

Chapter 6: Design Patterns, Anti-Patterns, and Judgment

  1. Patterns as a Shared Language
  2. A Practical Tour of Patterns
  3. The Anti-Patterns That Do the Most Damage
  4. The Meta-Pattern of Restraint

Chapter 7: Testing and Confidence

  1. What Testing Is Actually For
  2. The Test Pyramid and Its Trade-offs
  3. Test-Driven Development, Honestly
  4. Flaky Tests and the Cost of Untrustworthy Tests

Chapter 8: APIs, Interfaces, and Dependencies

  1. Designing Interfaces People Will Depend On
  2. Contracts, Versioning, and Backward Compatibility
  3. Managing the Dependencies You Take In
  4. Frameworks, Libraries, and the Framework Tax

Chapter 9: Architecture, System Design, and Distributed Systems

  1. What Architecture Is and Isn’t
  2. Monoliths, Services, and the Shape of the System
  3. Conway’s Law and Organizational Reality
  4. The Fallacies of Distributed Computing
  5. Designing for Failure and Scale

Chapter 10: Performance and Scalability

  1. Measure Before You Optimize
  2. Bottlenecks, and How They Move
  3. Caching, Batching, and Layering
  4. Throughput, Latency, and the Tail
  5. When to Scale, and When to Stop

Chapter 11: Data and Databases

  1. Data Is the Thing You Cannot Get Back
  2. Modeling Before You Pick a Database
  3. SQL, NoSQL, and Consistency, Honestly
  4. Migrations, Replication, and Sharding

Chapter 12: Reliability, Observability, and Debugging

  1. Reliability Is Designed In, Not Bolted On
  2. The Three Pillars of Observability
  3. A Debugging Method That Scales
  4. Post-Mortems and the Culture of Failure

Chapter 13: Security

  1. Threat Modeling Before You Build
  2. The OWASP Map
  3. Least Privilege and Defense in Depth
  4. The Human and Supply-Chain Layer
  5. The Cost Asymmetry

Chapter 14: Technical Debt, Refactoring, and Legacy Systems

  1. What Technical Debt Really Is (and Isn’t)
  2. Refactoring as Risky, Managed Change
  3. The Strangler Fig and Living with Legacy
  4. Why “Just Rewrite It” Usually Loses

Chapter 15: Building, Shipping, and Operating

  1. Version Control as a Discipline
  2. Continuous Integration and Delivery
  3. Deployment Strategies and Reversibility
  4. Infrastructure as Code and Environment Parity

Chapter 16: Teams, Review, Communication, and the Long-Term Strategy

  1. Code Review Done Right
  2. Estimation, Planning, and Commitments
  3. Communication and the Bus Factor
  4. What Actually Drives Developer Productivity
  5. Long-Term Engineering Strategy

Conclusion: The Common Sense That Compounds

References

Get the free sample chapters

Click the buttons to get the free sample in PDF or EPUB, or read the sample online here

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub