Chris Roos by Chris Roos

Week 356 - Interesting links

Documenting Architecture Decisions

We’ve been introduced to these Architecture Decision Records (ADRs) at GDS. They’ve been introduced to a number of projects (e.g. stagecraft, publishing-api and backdrop) and we’ve been encouraged to use them to record some of the significant decisions in Smart Answers (e.g. for the removal of Smartdown). I think our natural preference would be to record this sort of information (albeit not quite in this format) in our commit notes, although that can inevitably be quite hard to discover later. So far I quite like the idea of these ADRs and will be interested to see whether we end up using them on future projects. CR


This is the successor to the original HTML Tidy. The original comes pre-installed on Mac OS X but you can get the later version using Homebrew (brew install tidy-html5). I’m in the process of converting my static blog from Webby to Jekyll and am using HTML Tidy to normalise the output of each version so that I can use diff to work out what I still have to convert. CR


The Perl script colordiff is a wrapper for ‘diff’ and produces the same output but with pretty ‘syntax’ highlighting. Colour schemes can be customized.

I’m used to having ‘syntax’ highlighted diffs when using git diff but miss it when I’m using plain old diff. This script gives me nicely coloured diffs in the terminal. CR

A Client Project, Two Years Later

I really like this idea of going back to a project you worked on some time ago to find out how they’ve found working with your code and then writing about it. I’d like to try doing something like this for projects we’ve worked on. JM

From Bedrooms to Billions

A 2014 documentary film by British filmmakers Anthony & Nicola Caulfield that tells the story of the British video games industry from 1979 to the present day. The film focuses on how the creativity and vision of a relatively small number of individuals allowed the UK to play a key, pioneering role in the shaping of the billion dollar video games industry which today dominates the modern world’s entertainment landscape.

This documentary film and its companion book sound fascinating. JM

Fighting Uber’s Death Star with a Rebel Alliance of co-op platforms

I like really the idea of cooperative alternatives to the death stars of Uber, Airbnb, Facebook, etc. And this article makes it sound like an achievable possibility. JM

The Others

This was the improvised adventure story tweeted by Melinda throughout the day on Hallowe’en. I thought it was impressively intricate, especially given how she “pretty much just started tweeting on Saturday without any real plan on how the story would evolve”. Look out for part 2! JM

If you have any feedback on this article, please get in touch!

Historical comments can be found here.