Over the past year or so, as I’ve started to struggle to keep up-to-date with the multitude of websites that interest me, I’ve increasingly turned to RSS feeds to help me manage the load.

With that in mind, I’ve been compiling a list of Technical Communications feeds that I find interesting. Some are by Technical Writers, some are not, but I generally skim through the new items daily and I’ve yet to have a day when I didn’t read or find something interesting and useful.

If you have an RSS newsreader, then feel free to grab a copy of my subscriptions. If you right-click that link you should be able to download the file, and then just import it into your newsreader of choice (I prefer Google Reader).

And, of course, I’d love to know if I’m missing any. Hope you find this useful.

Just about finished at this years conference and, as ever, I feel fired up to get back to the office and get things moving. Overall the main theme of the conference was preparation, preparation, preparation, mainly focussed around gathering requirements before kicking off a project. Nothing special there but if you are considering moving towards a single source environment, there is a LOT of preparatory work you’ll need to consider.

I’ll amend this post tomorrow with some notes and thoughts from some of the sessions, but overall I’d highly recommend you visit X-Pubs next year. What follows is largely compiled from scribbled notes and random thoughts, but hopefully may be of interest. I’m not sure if copies of all the slides will be available on the X-Pubs website at any point, I certainly hope so.

Like most people, I ‘fell’ into the world of Technical Communications. I didn’t choose this career, and like many I didn’t study anything that remotely involved writing. But then, who really knows what they want to be when they are choosing what to study at university.

So, after spending a few years learning about Electronic and Electrical Engineering, and largely finding the entire experience boring, I packed that in and somehow found myself working as a Technical Administrator for a small local software firm. My Mother had spotted the job advert in the local paper and the rest, as they say, has passed under the bridge…

Having spent some time helping out at a local community centre, creating flyers and brochures for local charities and organisations, starting work as a Technical Author was a departure into a new ‘technical’ world. I learned a lot of things in that first job but the most important things can be easily summarised and stated that as “how NOT to be a good Technical Author”. Still, no-one can say I don’t learn from my mistakes.

Fast forward many years and I find myself in the position of knowing enough about my profession to understand how it can best help the company for which I’m currently working, and being comfortable enough about the processes involved with being a Technical Author that I don’t need to worry about them on a daily basis. I can quite happily paddle along, with nary a ripple cast in my wake. Of course I strive keep up-to-date with the latest fads and fashions in the world of information access and creation, technologies and methods which are constantly on the move, but the changes to the prevalent methodologies within the Technical Communications industry (the draft and review process for example) evolve rather slowly, and I have to admit that the lack of speed of progress in these areas is a concern.

Anyone involved with the software industry will have felt the varying effects of the internet, good and bad, as it has ripped across many different areas of technology, massively changing how people think about information. We, as Technical Authors/Writers/Communicators now work with a commodity which continues to rise in value as more and more people create and manipulate, publish and expose it for everyone to use. It’s no revelation to state that the internet has brought about an ‘information boom’ and this boom means that, for those of us working in the software industry, we need to rise and meet one simple expectation.

I want it now. No, I don’t want to look it up. No, I don’t want to have to read anything. No, I’m not that interested in anything else other than solving my current problem. Now. Please. Thank You.

Not even 10 years ago the expectation was different. The expectation had some built-in tolerance, an acceptance that information may need to be found, or at least filtered, from at least one source. Maybe that expectation was taken advantage of, maybe that expectation gave us an excuse to produce a level of product documentation that was ‘good enough’, as opposed to ‘better than expected’. Maybe not.

The field of Technical Communications prides itself on making information usable. Yes, there is a focus on making sure that information is complete, and accurate, but after that there is little point in having information if what the reader wants to find is hidden away behind some weird structure or methodology with which they are unfamiliar. There are a number of ways to presenting information to the user, and some consistent methods such as a Table of Contents, or an Index being the most common. However these all require some effort and in the age of instant access I’d humbly suggest that there is one growing universal truth by which all information must abide: If I can’t Google for it, why would I bother?

Of course it’s not all bad, one technological advantage of the “Google-age” is the relative lack of work required to make your information available to the mighty search engine. Put your PDFs, web pages, or even Word documents on a website and Google will find it. Simple enough.

However, to fully leverage the advantage and properly embrace the webcentric view so many people now have of the information world, we, as a profession, need to add another string to our bow, we need to master the skill of search engine optimisation (SEO). This is no small task but, naturally, the internet is brimming with information that can help, with plenty of hints and tips to get you started.

The world of information, both creation and usage, continues to change, I wonder what other skills we will need to develop?

Next week I’m heading down to Reading to attend the X-Pubs conference, where I’m hoping to learn more about both how a solid XML publishing solution is implemented and, ultimately, why I need to bother. OK, I know why I need to bother so I guess I should re-phrase that to “how I justify all the effort involved”.

I’ve done my fair share of research in the past, and have previously implemented an AuthorIT based solution. That worked reasonably well for our needs back then, but I’m with a different company now and the needs have, naturally, changed. I know all about the benefits of single sourcing content (re-use), and why XML is the best choice for storing that content (re-factorability, if that’s a word!) but as yet I’ve still not seen the killer product/solution that makes things:

1. easy to implement - I’ll accept some pain but most of the solutions I’ve seen have a fairly large knowledge mountain to climb
2. easy to adapt - I have, currently, very specific needs dictated both by the company and our product, and by my the needs of my team.

Of course no such solution exists, or we’d all be using it, right?

And that’s why I’m attending the X-Pubs conference.

I do believe that single sourcing is THE way to go about things in technical communications, almost (implementation costs aside) without reservation for any size of team and almost without regard for what they are producing. Like here in the UK, which is trapped between imperial and metric measurements, the technical communications industry seems to be a mix of differing output requirements. Some audiences demand printed manuals, some want websites full of searchable content, whilst others are happy with PDFs or online help. And that’s before we start worrying about localisation (localization).

I’m not entirely sure what I’ll discover at the conference, and I’m doing my best to keep an open mind, but I truly believe that the power of single sourcing will remain the refuge of the few until someone comes up with a workable, affordable solution that everyone can use.

I’ll be posting from the conference (possible even “live blogging”), so come back on the 4th June to find out what’s going on.

Do you single source? Or have you consider it in the past but never pursued it, and if so, why not?