« The way we design our software these days

December 6, 2010 • ☕️ 2 min read

Rory Gibson wrote a nice write up of Fred’s open space talk that did happen last Monday at the 10th XPDay in London.

Jamie wrote a comment on that post that deserves a reply.

He says:

You won’t know it works until later… What debt are they now in? What happens when complexity grows? How do they resolve conflict? Many start ups work because debt is hidden. If peer pressure is their number 1 hr strategy they will stagnate and not be able to respond to changes in their business.

The comment was mainly on our philosophy, another commenter on the blog post describes it as JFDI.

During my talk at the Agile Day I’ve got a comment that I forgot to mention in my post-talk write up.
One guy on the audience said, well you guys just design your software with a Unix Philosophy.

Oh man, this is so true.
It’s even on wikipedia.

I particularly like theMike Gancarz check list of the Unix Philosophy:

  • Small is beautiful.
  • Make each program do one thing well.
  • Build a prototype as soon as possible.
  • Choose portability over efficiency.
  • Store data in flat text files.
  • Use software leverage to your advantage.
  • Use shell scripts to increase leverage and portability.
  • Avoid captive user interfaces.
  • Make every program a filter.

Then let me paste here also the golden rules from Eric Raymond:

  • Rule of Modularity: Write simple parts connected by clean interfaces.
  • Rule of Clarity: Clarity is better than cleverness.
  • Rule of Composition: Design programs to be connected to other programs.
  • Rule of Separation: Separate policy from mechanism; separate interfaces from engines.
  • Rule of Simplicity: Design for simplicity; add complexity only where you must.
  • Rule of Parsimony: Write a big program only when it is clear by demonstration that nothing else will do.
  • Rule of Transparency: Design for visibility to make inspection and debugging easier.
  • Rule of Robustness: Robustness is the child of transparency and simplicity.
  • Rule of Representation: Fold knowledge into data so program logic can be stupid and robust.
  • Rule of Least Surprise: In interface design, always do the least surprising thing.
  • Rule of Silence: When a program has nothing surprising to say, it should say nothing.
  • Rule of Repair: When you must fail, fail noisily and as soon as possible.
  • Rule of Economy: Programmer time is expensive; conserve it in preference to machine time.
  • Rule of Generation: Avoid hand-hacking; write programs to write programs when you can.
  • Rule of Optimization: Prototype before polishing. Get it working before you optimize it.
  • Rule of Diversity: Distrust all claims for “one true way”.
  • Rule of Extensibility: Design for the future, because it will be here sooner than you think.

Now believe or not but you can trash away lots of books just following these rules. 
Unix is, IMO, the most stable software humanity ever wrote (think about unix, linux, macos and so on)

This is the way we work. 
We do have technical debt and we have plans to rewrite our small applications, we do that continuously, since they are small, modular, with a single responsibility (think about cat, ack, grep, etc… do) it’s never a big deal.