Category: Work

Mostly an archive of my posts from onemanwrites.co.uk – a blog I used to write when I worked in the Tech Comms industry

How rude

There is one thing I haven’t done here for quite a while. It’s rather remiss of me so please accept my apologies.

Quite simply, I wanted to say thank you. To you. Yes YOU.

Thank you for visiting this blog, and more importantly, thank you for coming back and visiting again. A lot of the ideas I talk about here are made better by your comments, and I continue to find blogging to be a useful way to work through some of the thoughts and random ponderings that float around in my head.

I tend, like many, to do most of my blog reading through RSS and I know that making the effort to comment on a blog is something that not everyone will do, and which some blogs can struggle with. It continues to amaze and delight me that anyone reads this blog, let alone takes the time to share their own hard-earned thoughts.

So, sincerely, thank you.

I is a Editor

(note to self: stop with the jokey bad grammar, peoples might think you cant be writing good)

I’ll say this quietly because I’m a little apprehensive but, for the next few months, it looks like we will have extra resource in our team. Basically we are ahead of the curve when it comes to recruiting so, until the rest of the R&D team catches up, we are one technical writer up!

Which means that we are taking the opportunity to both get ahead with some things, and catch up on others, and one of the things we’ve never tried here is to have a formal editoral review of the content. Peer review is one thing and whilst the technical content we produce is excellent, the differing writing styles and approaches each writer has does show through.

I’ll be the first to admit that I’m not all that bothered by this, simple business reasoning dictated that we concentrate on improving the accuracy and timeliness of the documentation and so, now we have done that, we can turn our attentions to other areas including findability and clarity.

The latter finds me taking on the role of Editor (I want to write Editor-in-chief just to conjure up images of a smoke filled newspaper office in the 50s), casting an eye over all of the content we produce and using our lightweight Writing Style Guide to prod and cajole the content towards something that, without being too restrictive, has a level of consistency for the reader.

As we haven’t had anyone performing that role before, it’s taking a bit of adjustment and the jokes about the “red pen” are already flying. Thankfully I work with smart people and it’s not taken long to see the results come to fruition.

What we need to figure out is how we change this model in the future so that we can all consistently edit each other’s work, lest I become a bottleneck in this process.

I’m cheating on you

I’m sorry, dear reader, truly I am. I feel bad, very bad indeed, guilty even. It’s not you though, it’s me, honestly. You are lovely, it’s just… well I wanted something different…

So I am writing blog posts elsewhere. Blog posts you might be interested in… I’m sorry I didn’t tell you before, but it’s just not that easy to bring up in conversation, you know?

Please don’t judge me, I will write for you again soon.

Ohhh, you want to see what I’ve been writing? Hmmm are you sure? Well, ok, but only because you asked so nicely.

West of Scotland ISTC meeting

The next ISTC technical communicators’ meeting in Glasgow will take place on Thursday 26th August 2010, from 7.30 pm onwards. Come along to talk about latest news and trends in communication, or just to meet other communication professionals.

The event is free and open to anyone interested in technical communication, such as technical authors, information architects, internal communication prodessionals, report writers, marketing writers, web content writers and graphic designers.

Venue: Waxy O’Connors pub, 44 West George Street, Glasgow, G2 1DH. Please make your way to McTurk’s Room on the middle level.

Please forward this message on to your colleagues or anyone else who may be interested. For more information, contact westscotland_areagroup[at]istc.org.uk.

Stop being serious

Information is serious stuff and must be treated with the appropriate earnest respect it deserves. Stop laughing at the back, this is not a joking matter. How do you feel when you go looking for information and can’t find it? Or find what you think will be helpful information only to discover that it is useless.

At that point, information is very very serious indeed and causes many people to gnash their teeth, wail their woes and other expressions of frustration and angst.

The reason I mention this, something I’m sure most of you are both perfectly aware and the unwitting recipients of, is because I have a tendency to be silly sometimes. Which means, say, adding an entry to a product glossary titled “Rubber Chicken” with a definition of “See Custard Pie” (and yes, the “Custard Pie” entry had the definition of “See Rubber Chicken”). Yes, it’s silly, but sometimes, if done correctly, a spot of humour can have a positive effect.

Thankfully the terminology used in software development can provide some perfect moments, so when someone recently asked “How do I destroy a custom component?” on an internal mailing list, one response (which alas I can’t post here) tickled my funny bone so much that I posted it to our developer community website.

Suffice to say that the response discussed destroying a custom component on a physical level (including dropping the hardware from a height) and the emotional level (including underming the confidence of the custom component with heavy doses of sarcasm) and had everyone who read it in stitches.

Was it inappropriate? Perhaps, but a little humour can go a long way.

And then… nothing

All quiet on the house front unfortunately.

But I have been able to crack on with some website work and as always it’s great when the client is accomodating, helpful and all round just a nice guy. Say hi to www.davidbelbin.com (then go buy one of his books!).

I’m also adding some functionality for a previous client, so I’ve got plenty to keep me busy AND I’ve found time to gently kick start my reading habit. Tackling the last of the Larsson trilogy which is a fun read in a Dan Brown kinda way. Mind you, I did read half of From Russia With Love before realising I’d already read it, oops.

The only other moment of excitement has been paying £4 for the privilege of receiving 4 rather shady looking photos of my fizzog. I need to renew my driving license and, amazingly, the photos actually look like me! (and no, I’m not showing you them).

Right, time to mark off another day in the “Hurry up I want an iPhone 4!” calendar.

Oh yeah, and football. World Cup and all that. If you need me, I’ll be in front of the TV.