David Barnes @ Packt

writing computer books that people want to buy 
Filed under

aha

 

Good writing should be like Alan Partridge -- business casual

       
Click here to download:
Good_writing_should_be_like_Al.zip (127 KB)


Writing a computer or other "how to" book, you walk a tough line between too formal and too informal. It's not easy to stay balanced.

Try to write in a way that it friendly, approachable, and shows some personality -- without imposing yourself too much on the reader. Think of how traditional chat show hosts create a rapport with their subjects, while retaining a respectful distance and letting their guests focus on themselves (something for which their guests need little encouragement).

Don't use stiff and starchy language. Use contractions (we're, let's, I'm) when appropriate. Don't use too many stuffy words that normal people only see written down (ergonomic, leverage, functionality, pedagogical). Write in a way that sounds good when you read it out loud.

But don't use slang either. Spare words like "cool" and "rocks". You're not Ali G and there's nothing worse than a teacher who tries too hard to get down with the kids. It doesn't make them seem credible -- it means they lose the credibility and authority that they might naturally have.

Dress your writing in tie and tank top. It's a good look on you

Loading mentions Retweet
Filed under  //   aha!   formality   pop culture   style   writing  

Comments [1]