On March 26th I giddily said it takes about two months to write a technical book. Still high from the recent success it seemed like the thing to do.
It is now May 9th. I am editing.
Well, sort of. I had thought my writing was awesome, that there will be hardly any editing needed and on 9th of April, just two weeks later, there was a reality check in my inbox.
It was the editor: "Hey this is really great, solid writing, I just fixed some spelling and markup for ya."
And truly, all the fixes were either typos or British English - they want American. Something about markets.
"Oh and shorten the book by 60 pages. We said 100, you wrote 180, we can do 120 tops."
*gulp*
It is now May 9th. I am editing.
The stickler is that my beta readers said they'd like even more content in the book, definitely not less. Obviously I can't cut any content out of the book and I can't make the code examples shorter either. People have already complained the examples are a bit terse and hard to understand at moments.
I could take out some screenshots, but this is a book about creating shiny visualisations for the internet. Screenshots must stay.
Only thing left is the writing. I have to go through the whole book and use less words to say more.
*gulp*
Facing such a monumental task it is therefore not a surprise I've only spent about 30 hours editing my book in the last month. That's averaging just an hour per day - the average for writing was two and a half.
And editing time isn't even half as efficient as writing time. For every two minutes of staring bleary eyed at the screen, dragging the words through my mind like so much barbed wire, I spend five minutes prancing about on the internet feeling like I'm riding a unicorn in comparison.
Editing really is sheer drudgery. There is no flow. There is no inspiration. Just a constant ruthless cutting and rewording. All those little things you thought added a special flair to the writing, let your personality shine through, entertained the reader.
Waste. Plain old waste. Vomit of a writer who's been staring at the screen too long.
It all has to go.
And the writing is much better for it. But you're still sad to see it all go.
Actually, not so much sad, as indifferent. You don't feel anything but the monotonous drudgery of rewriting something you've already written and not coming up with anything new. You can't, add something new and the word count goes up not down. Can't have that!
It's been fairly successful too. I've finished the first two chapters. One cut down from 14 to 9 pages, the other from 51 to 40. Just by improving the writing. No loss of content.
But it's just so ... it's terrible.
This weekend I discovered a trick, though. I was at a friend's place and as I was editing in the kitchen I realized that the chairs are terrible and the table is the wrong height.
Peeved, I moved to the counter. Editing standing next to the kitchen counter, shoulders slouched to stare at the screen ...
... before I knew it, two hours had passed and I edited five pages of text. Amazing! I had fallen into flow. Editing! Flow!
I don't actually know if this was because of my friend's kitchen or because I was standing while writing. But I'm going to repeat the experiment today.
Fingers crossed it works!
Continue reading about Write sitting down, edit standing up
Semantically similar articles hand-picked by GPT-4
- I published a book with a publisher. Here's what the journey was like.
- What writing a book feels like
- It takes about two months to write a technical book
- The true difference between self publishing and using publishers
- First lessons learned about writing technical books
Learned something new?
Read more Software Engineering Lessons from Production
I write articles with real insight into the career and skills of a modern software engineer. "Raw and honest from the heart!" as one reader described them. Fueled by lessons learned over 20 years of building production code for side-projects, small businesses, and hyper growth startups. Both successful and not.
Subscribe below 👇
Software Engineering Lessons from Production
Join Swizec's Newsletter and get insightful emails 💌 on mindsets, tactics, and technical skills for your career. Real lessons from building production software. No bullshit.
"Man, love your simple writing! Yours is the only newsletter I open and only blog that I give a fuck to read & scroll till the end. And wow always take away lessons with me. Inspiring! And very relatable. 👌"
Have a burning question that you think I can answer? Hit me up on twitter and I'll do my best.
Who am I and who do I help? I'm Swizec Teller and I turn coders into engineers with "Raw and honest from the heart!" writing. No bullshit. Real insights into the career and skills of a modern software engineer.
Want to become a true senior engineer? Take ownership, have autonomy, and be a force multiplier on your team. The Senior Engineer Mindset ebook can help 👉 swizec.com/senior-mindset. These are the shifts in mindset that unlocked my career.
Curious about Serverless and the modern backend? Check out Serverless Handbook, for frontend engineers 👉 ServerlessHandbook.dev
Want to Stop copy pasting D3 examples and create data visualizations of your own? Learn how to build scalable dataviz React components your whole team can understand with React for Data Visualization
Want to get my best emails on JavaScript, React, Serverless, Fullstack Web, or Indie Hacking? Check out swizec.com/collections
Did someone amazing share this letter with you? Wonderful! You can sign up for my weekly letters for software engineers on their path to greatness, here: swizec.com/blog
Want to brush up on your modern JavaScript syntax? Check out my interactive cheatsheet: es6cheatsheet.com
By the way, just in case no one has told you it yet today: I love and appreciate you for who you are ❤️