3 Things writers can learn from programmers

23 March 2010


At DevWeek last Tuesday, I saw Kevlin Henney deliver a talk based on the O'Reilly book '97 Things Every Programmer Should Know', which Henney edited.

He spoke about how the book came about: it's 97 things (and not 98 or 96) because that's the title of the series, but it's also consistent with how the book was crowdsourced, with leading programmers writing short essays on ideas. "If you want to get people to propose something, you want something that works on a page count basis,” said Henney. "If the page count [for each contribution] is too high, you exclude certain people from writing. A lot of people are happy writing blog length pieces of 400 words. Once you're talking about 1500 words, the blank page scares people off and you just get the professionals. You don't get a genuine cross-section of people.” He said 100 pages would be a pamphlet, 300 would be too much, but 200 is just right, which would be about 100 ideas covered in about 2 pages each.

If you're thinking about a similar crowd-sourced project, it's worth working from the book length back to the contribution length, considering who you want to involve and how much they can write.

What I really wanted to share from his talk, though, were a few ideas that I thought were as applicable to writers as they are to programmers.

His first thing programmers (and writers?) should know, is to do lots of deliberate practice. "You might meet someone and they say they have 15 years' experience,” said Henney. "That's impressive. But then you realise that what they have is one year's experience fifteen times, or six months thirty times. They've flatlined.” He said that he can juggle and play guitar, but that he hasn't improved much in 20 years because he doesn't spend time practising. How do you know when you're practising? Henney defined practice as being when the sole goal is to master the task, rather than to complete the task itself. Writing exercises can clearly play a key role here.

The second piece of advice he shared was to step away from the keyboard, so that you can let the ideas form properly. This is always worth remembering. Who has all their best ideas sat at a keyboard? Few people, I'd guess. Those writing in a corporate environment especially struggle with this, I believe, because taking time out to think is indistinguishable from skiving to the untrained eye, so people often feel they can't actually step away from the keyboard, even when they need a break to crack a writing problem.

The third piece of advice was to know the difference between a time estimate, a target and a commitment. In corporate writing environments, there is often negotiation around these when the writer says how long something will take (the estimate), the client or manager tells him or her to halve it (the target) and they agree a date somewhere in the middle (the commitment). The problem with this is that the estimate of how long the work will take hasn't changed, which means something has to give in the content or quality in order to meet the commitment. Trouble results when people confuse estimates and commitments.

The rest of the talk was more technical, and it would be too much of a stretch to relate it to writing. If you are interested in programming, the book content is available online here. Some of the contributions are superbly well written as well. If you can understand programmer speak, the book is worth dipping into just to appreciate the clarity of thought. If you prefer print, the book is also available at Amazon.

Labels: , , ,

Permanent link for this post | Blog Home | Website Home | Email feedback


Dip into the blog archive

June 2005 | September 2005 | January 2006 | March 2006 | April 2006 | May 2006 | June 2006 | July 2006 | August 2006 | September 2006 | October 2006 | November 2006 | December 2006 | February 2007 | March 2007 | April 2007 | May 2007 | June 2007 | July 2007 | August 2007 | September 2007 | October 2007 | November 2007 | December 2007 | January 2008 | February 2008 | March 2008 | April 2008 | May 2008 | June 2008 | July 2008 | August 2008 | September 2008 | October 2008 | November 2008 | December 2008 | January 2009 | February 2009 | March 2009 | April 2009 | May 2009 | June 2009 | July 2009 | August 2009 | September 2009 | October 2009 | November 2009 | December 2009 | January 2010 | February 2010 | March 2010 | April 2010 | May 2010 | June 2010 | August 2010 | September 2010 | October 2010 | November 2010 | December 2010 | March 2011 | April 2011 | May 2011 | June 2011 | July 2011 | August 2011 | September 2011 | October 2011 | November 2011 | December 2011 | January 2012 | February 2012 | March 2012 | June 2012 | July 2012 | August 2012 | September 2012 | October 2012 | December 2012 | January 2013 | February 2013 | March 2013 | April 2013 | June 2013 | July 2013 | August 2013 | September 2013 | October 2013 | November 2013 | December 2013 | January 2014 | February 2014 | March 2014 | April 2014 | May 2014 | June 2014 | July 2014 | August 2014 | September 2014 | October 2014 | November 2014 | December 2014 | January 2015 | February 2015 | March 2015 | April 2015 | May 2015 | June 2015 | September 2015 | October 2015 | December 2015 | January 2016 | February 2016 | March 2016 | May 2016 | July 2016 | August 2016 | September 2016 | October 2016 | November 2016 | December 2016 | January 2017 | July 2017 | August 2017 | October 2017 | November 2017 | January 2018 | February 2018 | August 2018 | October 2018 | November 2018 | December 2018 | January 2019 | March 2019 | June 2019 | August 2019 | September 2019 | October 2019 | January 2020 | February 2020 | March 2020 | April 2020 | May 2020 | June 2020 | September 2020 | October 2020 | December 2020 | January 2021 | February 2021 | May 2021 | June 2021 | October 2021 | November 2021 | December 2021 | January 2022 | February 2022 | March 2022 | May 2022 | July 2022 | August 2022 | September 2022 | December 2022 | March 2023 | April 2023 | May 2023 | June 2023 | October 2023 | November 2023 | January 2024 | February 2024 | Top of this page | RSS

Credits

© Sean McManus. All rights reserved.

Visit www.sean.co.uk for free chapters from Sean's coding books (including Mission Python, Scratch Programming in Easy Steps and Coder Academy) and more!

Discover my latest books

100 Top Tips: Microsoft Excel

100 Top Tips: Microsoft Excel

Power up your Microsoft Excel skills with this powerful pocket-sized book of tips that will save you time and help you learn more from your spreadsheets.

Scratch Programming in Easy Steps

Scratch Programming IES

This book, now fully updated for Scratch 3, will take you from the basics of the Scratch language into the depths of its more advanced features. A great way to start programming.

Mission Python book

Mission Python

Code a space adventure game in this Python programming book published by No Starch Press.

Cool Scratch Projects in Easy Steps book

Cool Scratch Projects in Easy Steps

Discover how to make 3D games, create mazes, build a drum machine, make a game with cartoon animals and more!

Raspberry Pi For Dummies

Raspberry Pi For Dummies

Set up your Raspberry Pi, then learn how to use the Linux command line, Scratch, Python, Sonic Pi, Minecraft and electronics projects with it.

Earworm

Earworm

In this entertaining techno-thriller, Sean McManus takes a slice through the music industry: from the boardroom to the stage; from the studio to the record fair.

Walking astronaut from Mission Python book Top | Search | Help | Privacy | Access Keys | Contact me
Home | Newsletter | Blog | Copywriting Services | Books | Free book chapters | Articles | Music | Photos | Games | Shop | About