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

Archive for September 2009

 
 

How I use Twitter

In his closing presentation at the recent Technical Communications Conference, RJ Jacquez outlined how he uses Twitter as a way to communicate with the users of his product, and as a way to share ideas with, and learn from, other technical communication professionals.

There were several people at TCUK09 that used Twitter throughout the conference, sharing quotes, thoughts and ideas about various presentations and I eded up having a few conversations about why I use Twitter so I thought I’d capture my thinking here.

I have two Twitter accounts, one for personal use and one for professional use. The personal account is used for keeping up with people I know in social terms, and most of the messages are chatty, with the occasional link or photo. I find it a good way to keep up with people but I don’t rely on it so if I don’t check it for a day or so then it’s not something I lose sleep about.

My professional account is used to share my thoughts about either my current work or on various aspects of our profession, responding to things posted by other people, or tracking through the myriad of useful links that people share.

And that to me is one of the key reasons for using Twitter. It’s a filter, a filter of trusted sources, that constantly points out things I wouldn’t have found myself and where I can have discussions with my peers about things that interest me.

Our profession covers such a wide area that keeping up with the latest trends and discussions on the fringes can be nigh on impossible. Twitter offers me a way to keep in touch, to be part of the conversation about these things, and whilst it can be seen to be frivolous, the value to be gained outweighs the downsides.

However, like most social networking or social media services, you get out what you put in and when it comes to Twitter, you really need to try it to find out if you can benefit for it.

You can follow me on Twitter.

Notes from Technical Communications Conference

These are transcribed from my hastily written scrawls throughout the day.

Smart Authoring for a Smarter Planet
The keynote presentation by Peter Angelhides

Set the tone well for bigger thinking about our profession, broadening the scope to the world wide consumption of information and how it can be processed intelligently.

Information for your products is useful both for existing users and for future customers. Don’t lock it away, let Google find it and then follow the links back, find other sources, other places where conversations about your product are happening. Information allows this, product usage doesn’t.

Everybody’s (not) doing it: is it really OK to keep ignoring document users?
by David Farbey

“Documentation is an asynchronous conversation” – Ginny Redish (from her book)

Training are usually separate from Docs, suggest either moving Training (we have!) or requesting debriefs after training sessions.

“Developer Mirror” is all too common – aka The Curse of Knowledge (you forget how much you didn’t know, so presume everyone knows things you know).

“The conversation needs to be focussed on what both parties want to improve”.

If you can write an article, you can write anything
by Kim Schrantz-Berquist

Applying Journalism techniques to writing
Using “5Ws & 1H” (Who what when where why and how) forces specifics and may end up change the subject of what you are writing about.

Inverted Pyramid – get the 5Ws and 1H into the first paragraph, top loading the information.

Use the “Stop reading test” to determine if it is working. How far down the page can you stop and feel comfortable you know the 5Ws and 1H?

Google Earth help manual uses hourglass technique, toploads information, then has area for user to choose what to do next, then has more detail/facts.

Good way to present Support Notes?

www.how-to-write.org

Paths to success: Networking and Contributing
by Linda Urban

Build your network and Make a contribution – these are the strings and glue of being successful.

Connection with people, conversations are where it all happens.

Visual Attention: A psychologist’s perspective
by Dr Chris Atherton

Attentionomics. Gestalt.

Extraneous cognitive load so less is more (see Nurnberg Funnel on minimalism in documentation)

Magic number is 4 (recent studies show), not 7 plus/minus 2!

We have two parts to the brain, one deals with audio processing, one deals with visuals. Both work at the same time (which is why we enjoy videos/webcasts so much), but quickly max out when we are only processing one type of information (which is why reading is tiring).

Without Hot Air
by Niall Mansfield

Discussed how information was presented in the book (which outlines real solutions for combatting global warming).

Book is available through Creative Commons to download.
Drafts were posted to blog to drive discussion. Aim was to share the information as it was public spirited content.

The secrets of Telepathy
by Justin Collinge

A double session covering ways to to communicate better by understanding how other people process information.

Filtering in effect – aural vs visual – McGurk effect, video on YouTube.

Looked at a variey of filters (aka meta-programming) including Direction (away from vs towards), Relationship (similarities vs difficulties) and Frame of Reference (internal vs external).

Audience of documentation will cover all types, yet we usually only write for one. Taking a set of instructions; it’s usually aimed at completing something successfully, but what of the people who like comparisons, or who want to make sure that something DOESN’T happen (troubleshooting info?)

Similarites – 70% of people start with these, emphasise these first then cover differences

Can write opening sentences which cover differences & similiarities, and ‘towards’ and ‘away from’ views – this matches the inverted pyramid writing style.

Future Vision of Technical Communicators
by RJ Jacquez

“Social media has redefined communication”

What makes an experience engaging? Accessible, Collaborative, Compelling, Easy to use, Personalised, Responsive.

Build experiences that engage your audience

Digital users are here (Grown Up Digital by Don Tapscott)

Socialnomics by Erik Qualman

Social networks have overtaken pron as the number 1 industry online.

SideWiki – comment on ANY website, no opt out. The conversation is happening now, whether you like it or not.

Thoughts on TCUK09*

Having had a few days to process my thoughts about the Technical Communications Conference I can confidently say that it is the best professional conference I have ever attended.

I’ll post up specific notes tomorrow, but I wanted to touch on some of the themes that seemed to be driven out of most of the presentations I attended. Now at this point I should make a confession, it’s about the presentation I gave on the Thursday morning (the second day) of the conference.

My presentation had a theme, a single word that I was focussing on, so throughout the first day, in all the sessions I attended, I was listening out for that word. That word didn’t appear in one session, and I had to push to get the word out of another of the speakers (the last of the first day).

I claimed that word appeared in all of the sessions I attended, it didn’t. Now, as far as confessions go, it’s not exactly earth shattering news but it’s important to me that I let you all know because, as I said in my presentation, if you are blogging you need to be honest.

The word I was looking for throughout the first day was “conversation”, and I was pleasantly surprised when I heard it crop up in the later sessions of the second day and I admit I was quite pleased when the closing speaker, RJ Jacquez from Adobe both mentioned my presentation and had a similar view to mine.

As for the sessions I attended, I don’t think there was one where I didn’t learn anything, even though there were a couple where I was asked to facilitate when I probably would’ve ducked out to chat to some vendors. It’s good that the speakers, whether well versed in public speaking or complete amateurs (like me), seemed comfortable and relaxed and really engaged with their audience.

And that for me is a good way to sum up the entire conference. I shudder to think just how much hard work went into organising the conference but from the smaller touches (the goodies in the hotel room), to the softer, informal approach that Paul and Rachel embody so well, really made a difference.

Given that our profession is both broad and deep, it was great to have other aspects around the fringes covered as well (cognitive psychology anyone?). All in all I think there was something for everyone, and the benefits of being exposed to other niche areas really made the conference worthwhile.

If you are in the UK next year, if you work in a profession either directly related to, or relatively related to, technical communications then I’d urge you to consider coming along next year. For me the best thing I’ll take away from the conference is the continuing conversation that is happening about our profession.

* #tcuk09 was the hashtag for the conference

At the conference

Morning, in a short while I’ll be delivering my presentation, trying to keep everyone awake whilst I waffle on about why blogging is the best thing ever and WHY AREN’T YOU DOING IT?? Or words to that effect…

Don’t worry though, dear reader, you can view the presentation and read through some of my notes although without my dulcet tones you’ll only be getting half the ‘experience’ (the best half, granted).

Although there is a small chance my session will be recorded so you may yet be able to get the full experience, I’ll confirm that later though (and depends on whether it can be edited as well!).

Wish me luck!

Conference Connections

I’m still tweaking my presentation for the Technical Communications UK conference, Thursday morning is looming larger and larger in my view so I’m distracting myself with considering the other good things that happen at conferences.

For me people are the primary reason for attending a conference. Don’t get me wrong, the value can be measured by the quality of the speakers and the information provided, but that tends to be transitory, so it’s the connections you make that count in the longer term.

I’m lucky that I’ve met some of the people I know through this blog, and I’m hoping to add to that tally this week. Part of me did consider trying to organise a little “meetup” of bloggers in attendance but I think I’ll leave it down to fate, I’d hate to NOT meet someone because I was concentrating on one small part of the crowd.

At times attending industry conferences can be a bit of a guilty pleasure, it’s only after the first hour or so you realise that yes, you CAN make jokes about the kerning on the dinner menu, or laugh at yet another example of Microsoft Word being helpful. It’s also acceptable to spend your entire lunch discussing whether audience surveys are a good thing, and whether you actually need to learn XML or not.

Obviously the presentations will drive some of the topics of discussion, but (and admittedly this is usual over dinner and a small beverage or two) conversation with your peers can lead to all sorts of other things. Chess boxing being one memorable conversation from a couple of years ago at TICAD.

So, despite still not being quite sure what the final form my presentation will take (I may also adapt it on Wednesday evening to reflect back on the speakers of the day) and not being 100% sure how I’ll get from the airport to the hotel (bus? taxi?), I’m starting to get a bit excited.

There will be a blog post published here on Thursday morning to coincide with my presentation, and I’ve no doubt I, and several others, will Twitter our way through the conference.

If you see me at the conference (I’m kinda hoping at least one or two people turn up for my presentation!) then rest assured, as long as you have either a coffee or a Guinness in your hand for me, I’m very likely to welcome you with a big smile.

Author-it Web Help Configuration Wizard

For version 5.3, Author-it released new web help templates and having played with them a bit I have to say I like them. However I was struggling to see how to enable some of the options that you can see in the example Author-it provide, so off into the HTML and CSS files I headed to see if I could see anything useful in there.

And there is, several of the options are commented out in the HTML code and with a little bit of poking and prodding I got some of them to work. Pretty straightforward, if you know HTML and CSS that is.

But what if you don’t?

Well the good news is that the ever productive Hamish Blunck has created an Author-it Web Help Configuration Wizard which, in a few simple steps, will produce you a custom Web Help template. It really is very simple and works like a charm, it also uncovered a few options I hadn’t spotted in the code.

Thanks to Hamish for providing this to the Author-it community (he also hosts a search engine that polls the old Yahoo Group). Great stuff this, go and give it a shot.

ISTC West of Scotland Group

The ISTC West of Scotland area group will meet on Thursday 22nd October from 7.30 p.m. onwards at the Waxy O’Connors pub, 44 West George Street, Glasgow, G2 1DH. Please make your way to McTurk’s Room on the middle level.

The evening will start with a discussion of “Conferences and how we benefit from them”, followed by an opportunity to network and chat with your peers (and hey, the bar will be open too!).

You don’t need to be an ISTC member to attend, and the more the merrier. Mine’s a Guinness!

Thanks to Katja McLaughlin for organising this. See you there.