one man writes
one man designs
one man blogs
one man tales

Archive for August 2010

 
 

Content Aggregation

I have an admission. I’m lazy. I work hard to get around that basic character trait but it remains there in the background, nagging away at me. Professional pride stops it influencing my work (I manage a lean, mean to-do list to keep me on track), but when it comes to things on the periphery I happily admit I’ll look for an easy, hassle-free solution if I can find one.

This has lead to me develop some little working habits which help me keep on top of the mass of information which I divert my way, largely through RSS feeds. I monitor many different feeds as I like to keep up with latest developments and discussions about our profession, it also makes it easier for me to write my monthly column – Blog News – for the ISTC Newsletter.

The workflow includes monitoring RSS feeds in Google Reader, and a web application called Instapaper which, with one click, bookmarks posts I want to read later. I then have another web application called Twitter Feed which monitors the RSS feed from Instapaper, and sends the links to my Twitter account as “retweets”. One click, gives me collation and sharing of articles and posts. Quite powerful.

Of course, at some point, there needs to be time to digest all this information and when it comes to that there have been a few interesting ideas appearing recently. These services will aggregate content by monitoring various places, and displaying the articles (links) they find in a more readable format.

In a way, Instapaper will do this, allowing you to read the text of an article without having to visit the website (a bit like Google Reader), but other services are starting to offer more graphical views, such as that provided by Paper.li.

The idea behind Paper.li is to create a ‘newspaper’ built from focussed articles. You tell it where to look for links and it does some nifty processing. Here’s one based on my Twitter account. It’s a bit basic at the moment, but has a lot of potential. I can see me using a few of these as ‘starting pages’, fire them up, get some coffee and spend a few minutes looking at intelligently collated content.

ISTC West of Scotland – Meetup

The next ISTC West of Scotland area group meeting will take place in Glasgow 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 professionals, 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, email westscotland_areagroup @ istc.org.uk

See you in September?

Are you in the UK? Are you attending the Technical Communication conference in September? If not, you really should, it’s looking like it will be an excellent conference.

The conference website is starting to gear up as well, and has posted some short interviews with some of the speakers, including yours truly. They should give you a flavour of what to expect at the sessions, many of which I’m hoping to be able to attend as well.

I’d imagine planning the sessions is one of the harder jobs when organising a conference, making sure there isn’t too much overlap and the programme this year seems to have a good balance. Certainly I think there is only one overlap with a session I would like to see that I can’t attend, but that’s because I’m presenting at the same time.

Hope to see many of you there, and remember, and this is the most important thing of all.

Mine’s a Guinness!

The Presumption of Common Sense

If there is one phrase which should set off alarms in the mind of a technical writer it’s when a developer says “Ohhh but they wouldn’t use it like that…”.

Because, as I’m sure you all know, they will.

I am currently working with a few people to try and pull together a solid set of product usage recommendations. We provide an SDK and a feature rich application built using our own technology, and that application is extended and configured for specific uses. There are plenty of hook points in there and, for the most part, usage follows accepted patterns. However there is always the time when a certain component is bent and twisted and used in a way we hadn’t expected and it’s these instances that we are trying to understand and capture.

We get a view of them by exploring edge cases when testing, but it occurred to me that there is still one thing that can catch us out. Our old nemesis, ‘presumption’ (which is usually coupled with it’s friend ‘common sense’).

So now I’m on red alert for any statements which are based on presumption. Sometimes they are right, but it’s the times when they are wrong that we need to explore them, capture them and help our customers by giving them some frame of acceptable usage. It’s not an exact science, but even just pausing to have those short conversations seems to be helping.

TCUK10 – quick guide

This is an update to a previously published post.

Not all of the sessions are scheduled yet, so I’ll update this as and when but, if you are wanting a quick print out of the session to, for example, convince your boss to splash some cash, then hopefully this PDF will do the trick:
Technical Communications Conference 2010.

(Note: a similar PDF is also available from the conference website but I think mine is prettier :p)

Do you do social?

I was doing some research last night, aimed at providing some real life examples of social media being used by a technical communications team. I’ve found a couple of places so far (Atlassian, I’m looking at you) but I need more.

It’s easy enough to find companies which have a “presence” on Twitter, or a company blog or suchlike, but they are mostly fairly static and little used. My fear is that, despite all the talk, and I include the team I’m part of in the following statement, we just aren’t using social media all that effectively yet.

Prove me wrong please!

If you, or your team have a blog, run a forum, push information updates to Twitter, host your documentation on a Wiki, or anything else along those lines, please let me know.