This blog is no longer being updated, but thanks for visiting. You can find me here.

one man blogs - click to start over

frozen tidal wave

Frozen Tidal Wave / Melting Glacier (via)
Stunning images.




See more like this: Miniblog, or link to this post

Leave a comment: Comments Off

How to make a cup of tea

Further to my Too Simple post, and in response to the comment from Annie about the state of software manuals, I thought I’d try and give a bit of insight into the basic workings of my profession. Yes, that’s right I DO have a day job. I am a technical author and I write software documentation (actually I don’t like the “technical author” job title but that’s a different story).

Before I begin I’ll state that I’m not the most experienced technical author (there are people who have been doing this for 40 years), I’ve only ever worked in a software environment, and as in most professions there are a number of different methodologies and working practises which I can choose to follow. OK, caveat finished.

Ohhh and you may be wondering about the title of this post so let’s start there, how DO you make a cup of tea?

It’s a question I’ve used in a writing test (for graduate technical authors or those new to the profession) in the past, and it’s usually fairly effective at giving a rough first impression of how the candidate thinks in relation to product documentation.

Now, I’d warrant that most people reading this have some idea of how to make a cup of tea, but let’s presume that you didn’t, in fact, let’s presume that you haven’t even heard of tea. Starting to get a little tricky, isn’t it.
(more…)




See more like this: Technology, Writing, or link to this post

Leave a comment: 26 comments so far

mitchell webb mac ads

UK Get a Mac adverts
Spot the comedians…




See more like this: Miniblog, or link to this post

Leave a comment: Comments Off

Previous Posts »