---
title: "Software Engineering: Tech Debt, Docs and Readable Code"
description: "Writing software that lasts: when tech debt matters, documentation people read, early returns and lower complexity, Conway's law, and planning before coding."
canonical: "https://www.trevorlasn.com/topics/software-engineering"
author: "Trevor I. Lasn"
last-updated: "2026-11-08"
---

# Software Engineering: Tech Debt, Docs and Readable Code

Writing software that lasts: when tech debt matters, documentation people read, early returns and lower complexity, Conway's law, and planning before coding.

24 current articles on Software engineering, newest first. See [every topic](https://www.trevorlasn.com/topics.md).

## 2026

- [Why I Chose Rust for 0xInsider](https://www.trevorlasn.com/blog/why-i-chose-rust-for-my-backend.md): No QA team. No on-call rotation. One person, one binary, one financial product. The compiler is my entire engineering org. (2026-03-09)

## 2025

- [Why I Value Firebreak Sprints for Managing Technical Debt](https://www.trevorlasn.com/blog/firebreak-sprints.md): How scheduled developer freedom weeks can revolutionize your codebase and team morale (2025-04-08)

## 2024

- [Recursion Explained In Simple Terms](https://www.trevorlasn.com/blog/recursion-explained.md): Understanding recursion through real examples - why functions call themselves and when to use them (2024-11-22)
- [Introducing the Legendary Programmer Hall of Fame](https://www.trevorlasn.com/blog/introducing-legendary-programmer-hall-of-fame.md): Meet the innovators who laid the foundation for modern computing. Their contributions span decades, creating the tools and concepts developers use every day. (2024-10-29)
- [How to Launch Software Projects On Time and On Budget](https://www.trevorlasn.com/blog/how-to-launch-software-projects-on-time-and-on-budget.md): Learn the art of scope management to keep your projects fixed in time and cost (2024-10-07)
- [When Tasked with a Problem, Start with the Bigger Picture](https://www.trevorlasn.com/blog/start-with-the-bigger-picture.md): Before you jump into a problem, step back and ask why it matters. How zooming out first, like studying the map in a strategy game, leads to better solutions. (2024-10-03)
- [Micro Frontends: The LEGO Approach to Web Development](https://www.trevorlasn.com/blog/micro-frontends-what-they-are-and-when-to-use.md): Micro frontends split a web app's frontend into parts that teams build and deploy on their own. Their key traits, when they're worth it and the challenges. (2024-10-02)
- [Make It Work First Before Optimizing](https://www.trevorlasn.com/blog/make-it-work-first-before-you-optimize.md): Users don't care how elegant your code is. They care if it solves their problem. (2024-09-27)
- [Minimum Viable Documentation](https://www.trevorlasn.com/blog/minimum-viable-documentation.md): How to create essential documentation that actually gets read and used. (2024-09-27)
- [Write Documentation Like a Journalist](https://www.trevorlasn.com/blog/write-documentation-like-a-journalist.md): Create comprehensive, engaging documentation by adopting journalistic techniques for research and storytelling (2024-09-26)
- [Conway's Law: How Your Org Chart Shapes Your Software](https://www.trevorlasn.com/blog/conways-law.md): Why software architecture ends up mirroring the org chart, the path of least resistance behind it, and how to work with Conway's Law or around it. (2024-09-24)
- [Outdated Docs Are Tech Debt](https://www.trevorlasn.com/blog/outdated-docs-are-tech-debt.md): Teams ship code and put off updating the docs until it is too late. How to find the docs that hurt most, keep them current and make updates part of the culture. (2024-09-22)
- [Weeks of Coding Can Save You Hours of Planning](https://www.trevorlasn.com/blog/week-of-coding-can-save-you-hours-of-planning.md): Weeks of coding can save you hours of planning. The old saying is still a warning worth heeding: how planning saves you, and how to keep it light. (2024-09-21)
- [Code Wins Arguments](https://www.trevorlasn.com/blog/code-wins-arguments.md): How Meta and other companies use the 'code wins arguments' mindset to turn ideas into reality (2024-09-19)
- [Take Your Writing Seriously](https://www.trevorlasn.com/blog/take-your-writing-seriously.md): Sloppy messages make everyone else spend time decoding them. Why clear writing respects your team, and the basic tips I follow for every message. (2024-09-19)
- [When Should You Actually Worry About Tech Debt?](https://www.trevorlasn.com/blog/when-should-you-actually-worry-about-tech-debt.md): Technical debt isn't the monster under your bed, but it can become one if ignored too long. (2024-09-12)
- [How to Reduce Cyclomatic Complexity: Practical Tips](https://www.trevorlasn.com/blog/tips-for-reducing-cyclomatic-complexity.md): Reduce cyclomatic complexity: split large functions, replace long conditionals with the strategy pattern, cut parameters and flatten nested loops. (2024-09-10)
- [Unrealistic Deadlines In Software Engineering](https://www.trevorlasn.com/blog/unrealistic-deadlines-in-software-engineering.md): Unrealistic deadlines are more than stressful: they set engineers up for failure. Who pays the price, and when to push back. (2024-09-07)
- [Explicit is better than implicit](https://www.trevorlasn.com/blog/explicit-is-better-than-implicit.md): Clarity is key: being explicit makes your code more readable and maintainable. (2024-09-04)
- [Early Returns and Intermediate Variables in JavaScript](https://www.trevorlasn.com/blog/embrace-early-returns-and-intermediate-variables-for-readable-code.md): Intermediate variables name each step of complex logic, and early returns handle failing cases first. A JavaScript authentication check, rewritten both ways. (2024-08-30)
- [When Regex Goes Wrong](https://www.trevorlasn.com/blog/when-regex-goes-wrong.md): A regex took Stack Overflow down for 34 minutes in 2016. How catastrophic backtracking works, plus the Cloudflare 2019 and CrowdStrike 2024 incidents. (2024-08-29)
- [Invisible columns in SQL](https://www.trevorlasn.com/blog/invisible-columns-in-sql.md): Invisible columns stay hidden from queries until you name them. How they work in MySQL 8.0.23+, Oracle and MariaDB, and alternatives in PostgreSQL. (2024-08-26)
- [Technical Debt Is Killing Your Business](https://www.trevorlasn.com/blog/technical-debt-is-killing-your-business.md): Technical debt frustrates 62.4% of developers, per Stack Overflow's 2024 survey. What causes it, and the outages at Target and AWS that show its cost. (2024-07-31)

## 2019

- [Programming Trends to Watch in 2020 and Beyond](https://www.trevorlasn.com/blog/2020-programming-trend-predictions.md): My 2020 predictions: Rust goes mainstream, GraphQL and PWAs grow, WebAssembly gains ground, React stays on top, and JavaScript stays a safe bet. (2019-07-19)
