Essay · 10 min read

The Joel Test: 12 Steps to Better Code

Joel Spolsky · Joel on Software Free Beginner

This is a three-minute list of yes/no questions you can literally walk through with the developer you hire, or use to size up the agency's habits. Questions like 'do you have testing?' and 'can you make a build in one step?' turn a vague worry into a score anyone can read. It is the fastest way to convert 'is this code any good?' into concrete things to ask about.

  • Twelve yes/no questions score a team's practices in minutes
  • A 'no' on tests or one-step builds is a real warning
  • You do not need to read code to use it

The question it answers

  1. How do I evaluate the code quality of a build I inherited from an agency?

Read with it

  1. Directly answers the scoping question non-technical founders wrestle with, build in-house vs. outsource, backed by patterns... YC Startup Library Article · ~10 min read Does Your Tech Startup Really Need a Technical Co-Founder? (Yes) Y Combinator
  2. This is the most concrete checklist we found for a founder who cannot read the code but can watch the behavior. It names the... VeryCreatives Article 10 Software Development Red Flags Every Non-Technical Founder Should Know Mate Varkonyi
  3. Before you pay anyone for a full review, point SonarQube at the repository for a cheap, automated first read. It scans over 40... SonarSource Tool · Tool, setup in an afternoon SonarQube Sonar (SonarSource)
  4. This is the canonical framing for exactly your question: not all messy code is the same. Fowler splits debt on two axes,... martinfowler.com Essay · About a 5 minute read Technical Debt Quadrant Martin Fowler
  5. This is the practical manual for improving code you are afraid to touch, without a rewrite. Feathers gives you techniques to... Prentice Hall (Robert C. Martin Series) Book · 456 pages Working Effectively with Legacy Code Michael C. Feathers
  6. The CTO of India's largest broker explains how a tiny team scales huge load by optimizing the application before touching... Zerodha Tech Blog Article · 15 min read Scaling with common sense Kailash Nadh
eChai Partner Brands The partnership →