Month: June 2008

Writer River

The unstoppable Tom Johnson has cranked out a new Digg-style website aimed at collating the best blog posts and articles about technical communications, as voted for by registered users (that’s you!). It’s a great idea, and I really hope it takes off (whilst secretly hoping that at least ONE of my posts makes the front page one day!).

WriterRiver.com is a social news site for technical communicators, which means you can both submit and vote on news stories. When you submit stories, they initially appear on the Upcoming Stories tab. After a story receives 5 votes, it moves to the Front Page Stories tab.

Go and check it out, get registered and start submitting.

Spot the difference

I’ve changed the name of this blog, well the banner image, from Informationally Overloaded to One Man Blogs. As no-one has mentioned this I presume no-one has noticed but there was some thinking behind this (and hey, you know me well enough by now that I have to analyse it a little, right?).

1. I know it pisses people off when I change things here, be it the title of the website or the URL that brings you here. I quite enjoy this so I try and change things once a year or so to keep you on your toes.

2. Most of the people who read this blog are web savvy enough to be overloaded with information at some point or another, so the title felt a little brash; MY information overload is more than YOUR information overload? Quite obviously it is not.

3. The simple fact is that I am not, and wasn’t really ever, overloaded with information. Yes I subscribe to hundreds of RSS feeds but I don’t feel compelled to read them all, and I’m reasonably good at keeping on top of the important things which allows me to quickly dismiss all the other stuff if needs must.

So there you have it. And no, you don’t need to update your links, although there are a few of you who STILL insist that my surname is McClean. It is not, it has one (small) c, like this: McLean. If you are one of these people, then I doubt this plea will make a difference but hey, a man can dream, right?

So there you have it.

What? Slow blog day? How very dare you!

I’m utterly failing in my attempt to make this a weekly feature on this site. Maybe I should cut it down a little, thoughts and comments are appreciated.

Writing an Interface Style Guide
Some handy tips for what to include in any user interface guidelines document:

Interface style guides are extremely useful to define best practices for design and development. However, keeping that information updated and functional is imperative. A glossary, an index, references, acknowledgments, etc., are among some of the supplementary details you can add to make the style guide as helpful as possible.

A Climate of Fear among Technical Communicators?
Prompted by a panel in the recent STC Summit, Ben Minson outlines some basic tenets of employment which, whilst we all know them, bear being repeated:

I think protection lies in being inventive. If management and your peers see that you go beyond the bare minimum and the mediocre because you’re interested in what you’re doing, they’ll see value. If you invent in order to solve problems and to benefit your team and the organization, they’ll see value.

Interestingly, this aspect of professional life raises some issues, some of which were encountered by Anne Gentle at the STC 2008 Summit.

STC2008 – Wrap up STC Summit trip report
Anne heard a couple of similar issues during the summit (as well as a lot of other great stuff), but she noted that:

proving that [an] idea needs to be implemented in the first place means understanding how to convince management of the value.

It seems to be something we all struggle with, providing ROI to back up our reasoning behind choices of tool and technology. Which brings me neatly to the next post…

What is the Best Metric to Measure the Success of Your Reuse of DITA Topics?
Of course you’ll have to have provided enough evidence to at least get a pilot project or proof of concept off the ground, but if you have, how do you get the most from the data you are capturing. Bill Hackos suggests you should measure the percentage of repository words that are reused in context:

The ratio of the repository content to the produced content metric works at the content level rather than at the topic level. This metric is proportional to actual costs because translation is charged by the word, and maintenance costs are proportional to the volume of content rather than to the number of topics.

I’m not a huge fan of such quantitative measures but sometimes needs must. The article mentions some other possible metrics, and if you are considering a single source rollout give it a look as it will spark some thoughts I’m sure.

Finally a couple of quick links that do exactly what they say on the tin:

A good book

We all know that there are many excellent writers out there who blog just as there are many bloggers who are excellent writers. This latter point is proven by the publication of You’re Not The Only One, a collection of stories written by people who blog, and which was compiled to raise funds for War Child.

So, if you want a good read, go buy it. Or if you just want to support a charity that works with the children trapped in war-torn countries, go buy it and then hand it in to a charity shop (two lots of karma in one go!).

For full details of the book, how it was compiled and who is in it, go and see the woman that made it happen.

I miss the plod plod plod

You know when, during a conversation with someone, something they say just clicks and seems so obvious that you wonder why on earth you hadn’t realised it until now? I had such a moment recently and the clarity of what was said was quite startling.

I’m mourning my ability to run.

It’s quite a simple sentence and, without wanting to belittle anyone who is mourning the loss of a loved one, quite a powerful statement. Powerful enough to make me request a physio appointment to try and get my knee sorted (any ability to exercise it would be good), powerful enough to make me decide that I should be doing some base exercises to improve my flexibility and strength, powerful enough to get me thinking about my diet and hopefully to make some proper inroads into weight loss.

The constant nagging reminders bounce past me on pavements, lithe and flowing like I never did despite picturing myself that way. Toned and controlled muscles in perfect motion I was not, but I miss the high, the achievement of a run in wild weather when sensible people are tucked up at home, the thrill of distance and speed, the banter and chat, the shared goals and breathless pain. I miss having that constant nag telling me to get to bed earlier, eat right, watch my posture, drink plenty of water, the little voice in my head that for once had a real chance of being heard, the angel in running shoes.

I miss being god of the morning, I miss it all.

But this isn’t a sad post, nor a plea for encouragement or help. Instead it is a public acknowledgement that I’m trying, that I’m doing what I can. I’m shouting into the void, the full fury of pent up frustration unleashed, leaving my desire quietened if not sated. It is a not a gushing, out-pouring of angst (honest, it’s not), but a quiet realisation that things change, as they always have, and that getting on with getting on is about all that can be done.

Why the internet is wonderful

Gather one, gather all, let me tell you a story, let me regale you with a simple yet powerful tale of the wonders achieved when the internet and compassion of (wo)man join in harmonious union.

OK, maybe not. But I do have an excellent example of how this interwoven online life we lead is actually a good thing… bear with me though, as this covers many tangents.

It all started with an RSS feed…

[cue wibbly wobbly dream sequence]
wibbly wobbly wibbly wobbly

[cut to dashingly handsome man, idly checking his RSS feeds]
(more…)