Year: 2012

Censored

Have you noticed anything different here? Maybe not, but those of you who have been reading for a while (thank you!) may have noticed that I’ve been managing to post here a couple of times a week recently.

Don’t worry if you didn’t notice, there is no test at the end.

I’ve been pushing myself to write to try and get my blogging mojo back, partly because I enjoy the process and the fact that it helps me keep in touch with what’s going on in our wider profession, and partly because there is a lot going on and I like to capture some of it.

But I can’t capture it all.

Looking back at this blog, there are some posts which hint at some things which ended up coming to pass. The signs are subtle and obviously I’m more tuned in to them than anyone else as I wrote it but they are there. It’s not that I want to be cryptic, more that I know that a sensible level of awareness and self-censorship are one of the most important skills to learn as a blogger. Whilst the opinions stated here are mine, and mine alone, I simply can’t post things which might compromise the company I work for in any way shape or form.

And so, as I started to pull together some notes with a view to publishing them on this blog I realised I wouldn’t be able to, not at the moment.

Suffice to say that the next few months could see some interesting challenges and changes, and as soon as I can I’ll be discussing them here (and my Twitter feed is likely to be reduced to a serious of exasperated noises). I am feeling excited, nervous and ready for what lies ahead and hopefully as we learn lessons here, I can share some of them with you.

That said, if there is anything you’d like me to tackle, any questions to ask, please get in touch. Always happy to help.

 

Cycling: Wed, 31 Oct 2012 21:35:00

  • Activity: Cycling
  • Distance: 7.5 mi
  • Duration: 00:31:00

The Death of Tradition

Job titles are one thing, but what do you actually do? Are you a ‘traditional’ Technical Author or a modern technical communications professional? Is there a difference?

I think there is, I think there is a distinction between the two although I’m not quite sure where that line is drawn and, as with most things in this multi-discipline profession of ours, the line is probably blurry and not all that straight.

For me the line separates what I consider the old and the new, the line between traditional technical writing and the modern day technical communicator, and I think the distinction is largely around the approaches each type of professional take when it comes to managing content.

I realise this may seem a little contentious, and possibly a little divisive (pun intended), so let me explain.

At the recent West of Scotland Area Group meeting, a few of us started discussing this. We all agreed that the traditional notion of what a technical writer (author) does has changed and that the change was driven mostly through technological advances.

For most modern companies, gone are the days of the author, editor, and illustrator producing printed documentation. The rise of the internet has changed the understanding of information and so our job roles (if not our titles) have morphed into what we do today, we write, we draw, we collate, filter, edit and publish information from a wide variety of sources, we care about the user experience of the product, and we push all of that information and knowledge out in many different formats, to different devices in radically shrunken timescales. We write topics, not pages, and publish to online portals, not printed and bound manuals.

From what I can tell, and I’ll admit that I’m not best placed to comment on any of this, I’ve only ever worked in software companies, but chatting to people at conferences and so on it does seem like the more traditional (old-fashioned?) approach of having a team – where the technical author writes the words, the illustrator draws the diagrams and artwork, before their work is combined and sent to an editor before being printed en masse – is slowly shrinking. For me it seems like that approach is typically based around some level of regulation (or litigation) meaning the scope of the content, choice of format, and even the list of final deliverables is impossible to negotiate.

Meanwhile, freed of such constraints, many of us find ourselves free to choose not to document a small change in an obscure and little used part of our product, and able change what we deliver and how we will deliver it.

Is it fair to be so black and white? Is there really a line, a divide, within our profession?

After all, my exposure to other technical communicators is largely through online sources (blogs, twitter, articles) and as those of us in the software industry have a vested interest in understanding these different mediums, it makes some sense that we are the ones making more noise than our counterparts who work in industries that demand paper-based outputs.

I think the disciplines required to work in a regulated industry are starting to differ more and more from those of us who can have input into the scope of what we do (and what we don’t do). There is a risk that future professionals won’t be able to cross that gap, they won’t understand (or want to understand) why they have to have numbered paragraphs, or why every single change must be traceable to the root requirement.

Over time, the more traditional roles, or rather the industries within which they operate, will start to come more towards a more modern view, in fact they already are. Airlines are allowing iPads onto flight decks, more connected systems of documentation and information capture forms are being seen in car production factories, and as further industries invest in modernising their infrastructures, so to must the technical writers.

Reflection

It seems like no time since I was looking forward to the summer. The holiday in Singapore was months away, Pedal for Scotland was a spot in the distance and ohhh yes I was gonna get so much done.

In the past I think I’d now be sitting here saying “Christ, it’s almost November, what have I achieved?!” but these days things are different. Yes I could’ve done more but I’m more focussed on being happy than being productive (even though the two are inextricably linked), on getting the balance right between the stuff I want to do and the stuff I have to do, and generally I find myself calmer, more rational and more aware.

The darker nights bring a different focus, of course, and now is the time to be exploring new hobbies, creating new routines into which I can add a few more notches of self-improvement to my belt.

But there is no rush, no hurry. Not today.

I’ve given out this piece of advice a few times in the past few years, and I realise it’s something I’m more and more keen to make sure is part of my day. It can take mere seconds, but without it the world can seem a horrid and dark place.

So, today, stop and appreciate a moment of beauty. Whether it’s watching the raindrops race down a window, the elegant swoop of a gull on the breeze, or admiring the hazy moon at night there is so much more to life than the constant strive for everything now, faster, better, more.

Step outside all of that for a second, breath deeply and be content in the moment. Today is only today for a short while.

Content Strategy is easy

Why are we still banging on about Content Strategy?

Is it really that hard?

A strategy shouldn’t be that tricky to formulate, especially as it’s concerning an area of expertise for many us, after all it’s only content, right? It’s not like it’s something new that none of us know anything about? So why is it so hard and why do we spend so much time talking about the whys and wherefores and, seemingly, so little time actually doing it?

Content Strategy is an area of our profession I’ve taken an increasing interest in. As the value of information rises, making sure you have a sensible strategy that is concerned about getting the best content required, for the right person in the right situation at the right time, has become increasingly important.

Even before Content Strategy became an entry on conference buzzword bingo sheets, making sure the content you were creating was offering the best ‘bang for the buck’ was something on the minds of all good technical writers. Sure, we could write documentation that would cover every aspect of the product but not only was that very difficult to achieve, leaving aside regulatory requirements, would all of that content be needed and used? Probably not.

Looking further afield, beyond documentation, many companies today are starting to realise that information and knowledge have more value than they realised, and so they are starting to treat content as a commodity. That means, for those of us who spend the majority of their time thinking about, planning, creating, and delivering content, our stock has risen and we have opportunities to do more, gain a stronger position in our organisations and flex our information management muscles!

And so we get to the tricky bit. For many people who don’t spend a lot of time worrying about content, it seems a bit grandiose to have to have a strategy around something that has been taken for granted or, in the worst cases, ignored altogether. Once you mention that having good control over the content being produced, with a view to improving how it is created and delivered, will cost money, suddenly the picture changes.

As companies start to better understand the link between content and the experience their customers have during their interactions with the company and the product they are using, so the need for better content, supporting and driving better user experiences, will rise.

None of this is new, these ideas have been talked about and debated for several years under the guise of Content Strategy, and for far longer than that in terms of ROI of content (and the teams who deliver it).

If you’ve been on the edge of any of these conversations, and wondered how on earth you could get such an initiative in place at your company then good news! Two leading experts in this area, Rahel Baillie and Noz Urbina, have combined their talents to write Content Strategy for Decision Makers.

Interestingly, you can’t buy the book in printed format yet, but you can read it and comment on it on the book website: http://contentstrategyfordecisionmakers.com/

It’s only online for the month of October, so I’d urge you to hurry along! It will be in print soon regardless, and I know it’s already on my wishlist.

Cycling: Wed, 24 Oct 2012 21:40:00

  • Activity: Cycling
  • Distance: 5.2 mi
  • Duration: 00:20:00