Posts Tagged ‘documentation’

I’m writing this for my fellow DXCers, but I’d expect the points I make here likely apply to any open source project. The first thing I’ll check is the README.md Because that’s the first thing that somebody visiting the project will see. Is the README written for them – the newbies – the people who’ve […]


Originally posted internally 16 Aug 2016: The title of this post comes from a tweet by Evan Goer I saw last week. It’s derived from Michael Pollan’s statement from In Defence of Food: ‘Eat food. Not too much. Mostly plants.‘ Write code Just as food fuels our bodies, code fuels our industry. The world is moving […]


This was originally published internally on 4 Dec 2015, my 4th day at CSC: My first few days have made me think carefully about where I see value. This is what’s emerging: I value code with documentation, samples and examples more than just code, because code with documentation, samples and examples gives us a repeatable […]