// Topics / Developer Experience

Developer Experience

Definition

Developer Experience coverage in this archive spans 12 posts from Mar 2019 to Mar 2026 and leans into practical engineering craft: interfaces, testing, and maintainable implementation details. The strongest adjacent threads are devops, platform engineering, and ai. Recurring title motifs include ai, developer, docs, and platform.

Key claims

  • The through-line is clarity first: simple designs that survive change beat clever abstractions.
  • Early posts lean on internal and platform, while newer posts lean on docs and ai as constraints shifted.
  • This topic repeatedly intersects with devops, platform engineering, and ai, so design choices here rarely stand alone.

Practical checklist

  • Keep interfaces small, automate regressions early, and make operational assumptions explicit in code.
  • Start with the newest post to calibrate current constraints, then backtrack to older entries for first principles.
  • When boundary questions appear, cross-read devops and platform engineering before committing implementation details.

Failure modes

  • Abstracting before usage patterns are stable enough to justify indirection.
  • Treating style consistency as optional until quality and velocity both degrade.
  • Applying guidance from 2019 to 2026 without revisiting assumptions as context changed.

Suggested reading path

References

11 entries tagged “Developer Experience”

    AI Docs That Don't Lie to Your Users · 4 min Most AI documentation systems retrieve the wrong version, hallucinate details, and never admit uncertainty. Here's how to build one that actually helps. documentation ai search Let AI Write Your First Draft, Not Your Docs · 3 min AI is a decent drafting assistant for technical docs. It's a terrible replacement for ownership. documentation ai technical-writing Platform Engineering: DevOps Grew Up · 4 min Platform engineering is what happens when you realize 'you build it, you run it' does not scale past a handful of teams. platform-engineering devops developer-experience Monorepo vs. Polyrepo: A Practical Decision Guide · 4 min Monorepo or polyrepo depends on coupling, team shape, and your appetite for build tooling. Here is how to decide without getting religious about it. architecture monorepo git Your Engineering Docs Are Probably Useless · 4 min Most engineering documentation is ignored for predictable reasons. Here is how to write docs that people actually read. documentation engineering developer-experience Your Onboarding Is Broken. Here's the Fix. · 3 min Most engineering onboarding wastes the first week on access requests and context overload. The fix is simple: ship a real PR by day three. onboarding engineering-leadership teams Most Platform Teams Are Building the Wrong Thing · 6 min After assessing platform maturity at a dozen enterprises, the pattern is clear: most platform teams build tools nobody asked for while developers wait in ticket queues. platform-engineering devops developer-experience Developer Portals: The Thing Nobody Wants to Build But Everyone Needs · 5 min What I learned helping large telecoms build internal developer portals, and why the service catalog is the only part that actually matters on day one. developer-portal platform-engineering backstage How I Build CLI Tools in Go (And Why I Stopped Overthinking It) · 8 min A deep dive into building Go CLIs that feel right: cobra patterns, structured output, signal handling, and the small decisions that separate a script from a tool. cli golang tooling Internal Platforms vs. Ad-Hoc Tooling: Which Developer Experience Actually Wins · 6 min A comparison of two approaches to developer experience -- purpose-built internal platforms versus the organic tooling that teams build for themselves -- and when each one actually delivers. developer-experience platform-engineering devops Your Internal Platform Is Probably a Liability · 3 min Most internal developer platforms fail not because they're technically bad, but because nobody treated them like a product. Thoughts from building (and scrapping) platform tooling across three startups. platform devops developer-experience
All topics →