: Re: Can technical writing suck less I currently have the prospect of writing a considerable amount of technical documentation (describing interactions with an extremely complex online service). I consider

@Moriarity138

Vote Up Vote Down

One way I use is to make a little joke in between. Like 1. Plug in. 2. Do it again, this time upside down, you got it. 3. Connect. 4. Watch.

Burgess used something like this in Earthly Powers. The protagonist had grabbed an artificial leg and Burgess was describing how he was handling it as a weapon (the technical point) and then he said that it was like he was an artificial leg seller and thinks something like 'Here lady look at the quality of this leg, the best leg you'll find' and then he swings it at some person. (This is not the exact quote.)

Or you can write some description in between, like

X was reading the manual '1. Plug in', it said. X plugged it in. 'Nice. Next step now: 2. Connect'. 'All right! Let's connect...'

etc.

This is something you can do quite easily and keep the interest of the reader.

(0)

Login to post a comment!