A Short Story About Verbosity
Programming in the 21st Century - James Hague - March 17, 2010In the early 2000s I was writing a book. I don’t mean in the vague sense of sitting in a coffeeshop with my laptop and pretending to be a writer; I had a contract with a tech book publisher.
I’m in full agreement with the musician’s saying of “never turn down a gig,” so when the opportunity arose, I said yes. I did that even though there was one big, crazy caveat:
“In order for a book to sell,” said my publisher, “it’s got to be thick. 600 pages thick.” “In the worst case we could go as low as 500 pages, but 600+ should be your target.”
Wow, 600 pages. If I wrote two pages a day, that’s almost a full year of writing, and I had less than a year. But still, never turn down a gig, and so I took a serious attempt at it.
I can’t prove or refute the claim that a 600 page tech book sells better than thinner ones, but it explains a lot of the bloated tomes out there. Mix sections of code with the text, then reprint the whole program at the end of the chapter. That can eat four or eight pages. Add a large appendix that reiterates a language’s standard library, even though all that info is already in the help system and online. Add some fluff survey chapters that everyone is going to skip.
I try not to wax nostalgic about how the olden days of computing were better. While I might have some fond memories of designing games for 8-bit home computers, there has been a lot of incredibly useful progress since then. But I do find myself wishing that the art of the 250 page technical book hadn’t gone completely out of style.
Eventually I did give up on the 600 page monster I was writing. It was a combination of me not having enough time and my publisher taking weeks to give feedback about submitted chapters. In the end I think I had written the introduction and maybe eight full chapters. Do I wish I had finished it? Yes. Even with the 600 page requirement, there was still some clout that went along with writing a book at the time. These days it’s much less so, and I think those padded-out-to 600 pages volumes had a lot to do with it.
(If you liked this, you might like Two Stories of Simplicity.)
Categories: Blogs Programming in the 21st Century
Erlang on Twitter
» TheColonial (OJ): @bryan_hunter next stop #erlang ;)
» Sari1Rini (Rini Anita Sari): Hihi doni ² mls digedein :p RT@doni_erlang: Bukan jorok tp lagi males haha “@Sari1Rini: Hiiih ternyata doni jorok sekali -___- RT@doni_erlan
» AshleyC01715191 (AshleyChapman): The wherefore erlang expatiation has an acridity extremely insular technologies entryway grille extension?
» olgeni (Jimmy Olgeni): devel/meck is out - let’s add more Erlang ports
» nivertech (Zvi): Building Skynet, Erlang/OTP talk by Zachary Kessin, DevCon TLV, June 20: http://t.co/XLZOQtSNBK
» GregPayne (Greg Payne): Free Tidbit for today: 1 erlang is equal to 64 kbps * 3600 seconds * 1 byte or 8 bits = 28.8 MB traffic in one hour
» Muh_Erlang (M. Erlangga Pangestu): @Rexy_19 asli
» penguinjournals (David González): @highwayman iba mas por las máquinas,lo de erlang ya me sonaba,es mas tienen picos de numeros de peticiones simultáneas que asustan
» highwayman (David Santamaria): @penguinjournals mucho Erlang segun cuentan en su blog, aqui una presentacion de uno de sus engineers https://t.co/VtmN4VoLGv
» the_real_nisbus (nisbus): RT @dch__: .@dscape @izs you might be interested in how erlang schedules work using reductions http://t.co/CJKy6bGqjP and http://t.co/aTHEb…
Statistics
Number of aggregated posts: 10650
Most recent article: May 20, 2013
Latest comments
» Moraru on This is Why You Spent All that Time Learning to Program: It is true that computer science was a pain in the back at time that i’ve had to learn it…
» Commercial hand dryers on Couchbase Meetup at new HQ: Buy online from here where you will get so much of variety in Commercial hand dryers for people. If you…
» Fort McMurray Homes on Motivated Reasoning and Erlang vs Python vs Node: I don’t really understand why this post is motivational? I don’t even see a post, just a title. Fort McMurray…