Podcast

Welcome to the ITauthor Podcast. If you haven't been here before, this is a technical writing podcast, aimed at technical communicators or anyone interested in software documentation. The latest podcasts are on this page. You can listen to the podcasts here and now by clicking the play button on the audio player at the top of the show notes for each podcasts, or you can subscribe to the podcast feed or the email list. All of the previous podcasts are available on the Podcast Archive page. Please feel free to leave a comment or ask a question. Thanks for visiting!

ITauthor podcast #22 – Getting into the writing zone

December 7th, 2008    2 Comments

The voices in this podcast belong to: Graham Campbell and Alistair Christie.

stackoverflow-logo-250 On a recent StackOverflow podcast, a listener asked the presenters for tips on how to "get in the zone" as a programmer. We take up the theme here and talk about how you can get yourself in the writing zone as a technical writer, and we try to identify the things that prevent you from getting in the zone.

Preparation

Do adequate research up front so that by the time you you start writing you can continue writing without having to keep stopping to check things out because you know your subject.

Avoid distractions: Email

Resist reading your emails throughout the day, as they arrive. If you *do* read your emails, resist the temptation to act on them there and then. Make a note of things you need to do and come back to these things later.

Avoid distractions: The Internet

One Web page draws you to another and another and another, and before you know it half an hour has passed. Steel yourself to stay off the Internet. When you *do* need to visit a Web page, imagine you're back in the days of expensive metered dial-up, when using the Internet was a case of getting on there, getting was you needed as quickly as possible and getting off again. Just imagine you're paying from your own pay packet for each minute you spend on the Web during work hours.

Listen to the right kind of music

This one's a personal thing. I can mentally turn down the volume on conversations going on around me in the office, so that I'm not distracted from what I'm working on, until someone says my name a couple of times. But you might be the kind of person who finds that difficult and naturally can't help but listen to whatever chat is within earshot. If that's the case you might find it useful to put headphones on and listen to music. But it has to be the right kind of music. If you play songs you'll be listening to the lyrics. If you play music you really like, you'll be busy enjoying the music rather than writing. If you play mood music, you've got to make sure it's the right kind of mood: if it's too reflective or sombre it may bring you down. Graham recommends film scores (e.g. the music from the Transformers movie). I rarely listen to music while I'm trying to work because I tend to find the music gets top priority in my mind and I find time will pass and I suddenly realise I've just been listening and not working. One time the folks around me were chatting a lot, and too loud to tune out, so I listened to some free background music I'd downloaded for the backing track of a video demo I'd produced. The music was very innocuous and repetitive and I played it on a loop. That worked pretty well. I also sometimes use headphones with no sound just as a visual "don't talk to me" sign. That's pretty effective if you need to get on with work and don't have time for chatting.

The "meh" effect

It's Monday morning and the weekend just wasn't long enough, or you had a bad night's sleep, or you had an awful commute to work. You need to find something to raise your spirits, shake off those negative feelings and get yourself into a frame of mind where you want to do some good work. How you do this is going to depend on your own psychological traits and what works best for you. So if rewards work for you, you could promise yourself a reward of some sort if you get a realistically achievable amount of work done - just to get you going. For example: if I write 2 decent-sized help topics by lunchtime I'll buy myself a slice of chocolate cake to have with my coffee at lunch.

Meetings

Avoid attending meetings that you don't really need to attend. Can someone else who's going to the meeting report back to you with a highlights version of what was discussed? If you need to go along to the meeting can you be called into it just the bits that directly concern you and then duck out when the discussion moves on? If not, and it's a long meeting, can you take in a laptop and do some work (even just catching up on email) while other attendees are discussing issues that don't concern you? For all meetings, make sure they're time boxed. If the meeting is scheduled from 2 till 3, make sure everyone knows that you've got something you need to do at 3. If you can, time-box contributions within meetings. We use a little application called Dinner Timer [LINK AND PIC] that gives the person raising an issue a set time to discuss that issue. It counts down on the screen and sounds an alarm at the end of the allotted time, at which point the meeting moves on to the next issue.

When you're in the zone, stick with it

Working late when things aren't going and you're having an unproductive day isn't particularly smart - better just to go home and tell yourself you'll get in early the next day. Go home, relax, have a nice meal, have a long soak in the bath, get a good night's sleep. But when you *are* in the writing zone, hang on in there and make the most of it.

Give yourself realistic deadlines

Nobody works efficiently if they're working under stress. If you make your own schedules, try to make sure the dates are achievable. If someone else gives you a schedule, don't agree to dates unless they're achievable. It's going to be less stress overall if you have a bit of aggravation up front renegotiating a schedule that has a better chance of success.

Don't expect to always be able to get in the zone

When you're working on a larger project (e.g. an iteration of development on a new product) you have more chance of getting in the writing zone and having really productive days. But for some types of documentation work that's just not going to happen.

 

Recommended applications

 

Adobe Lightroom: http://www.adobe.com/products/photoshoplightroom/
lightroom_150x150 
Microsoft PhotoSynth: http://photosynth.net
photosynth-fortboyard

Foldersizes: http://www.foldersizes.com
foldersizes

 

 

Recommended podcasts

 

Steven Fry's Podgrams
stephenfry
Right now the RSS feed for this podcast is broken, but here's a link to Steven Fry's Web site:
http://www.stephenfry.com/media/


A Way With Words
waywithwords-small
KPBS Radio in San Diego
http://www.waywordradio.org
http://feeds.waywordradio.org/awwwpodcast


The music I play at the beginning and end of the show is by Amplifico. You can hear more of their music at Podshow.

Want to get emailed next time I publish a podcast?
Preview

RSS icon  iTunes_logo Blubrry_logo feedburner

Comments

  1. User Gravatar Tom Johnson said:

    December 12th, 2008 at 5:05 pm (#)

    Alistair, I just wanted to drop you a note to let you know I've been listening to your podcasts and following your blog posts. I've only listened to one of your three generation interviews, but I really enjoyed it. I also enjoyed your discussion about productivity. In some ways, listening to your podcast makes me feel as if your my virtual colleagues.

    I don't get many comments on my podcasts, but I realized something as I was listening to you and Graham. While the number of podcast listeners may be fewer in number, the connection that users make with podcasters is on a scale far above blog posts. I scan through dozens of blog posts each day, and often skip over the authors. But when I listen to a podcast, I feel like I'm hanging out with the hosts for an hour. The connection is much more personal and powerful.

    I'm glad to see you publishing so many podcasts, and I hope you continue at this rate. I too am trying to do more podcasts, even though I haven't done many lately.

    Also, I enjoy the podcast recommendations that you include at the end of your podcasts.

  2. User Gravatar Alistair said:

    December 14th, 2008 at 10:34 pm (#)

    Tom

    Thanks for getting in touch. I've been trying to do more podcasts but, although the stats I have suggest most shows get downloaded a few hundred times, I have no way of knowing how many of those downloads are ever listened to. So it's always nice to know that there is someone out there listening to some of them. Keep up your prodigious blogging work and I look forward to hearing more podcasts from you in the near future.

    Also, kudos for WriterRiver - it's a great idea and helps to keep the tech writer community well informed without requiring us all to read everything out there. As long as someone posts up anything really interesting they've come across, then everyone gets to hear about it.

Leave a comment

 

ITauthor podcast #21 – Three generations of computer users (Part 2)

November 23rd, 2008

MarthaChristie I wanted to find out how people of different generations use computers, what they use their computers for, how they use them and what they feel about computers and software generally. So who better to ask than three generations of women from my family.

In this, the second in a series of three podcasts, I talk to my 17-year-old daughter, Martha Christie about how she uses computers at school and at home.

Of online help Martha says:

"Those things drive me crazy. I don't think I've ever actually used any of those help systems for anything on the computer. I just don't find them useful at all.
...
There's so much writing to read and I hate that kind of thing. It's like ... if you get like a help manual with something you just throw it away before you start
...
I just can't read through it all. I'd rather just try it and then if it goes wrong I just scrap it and start again."

On the most effective way of learning, she says:

"If you want to learn something, asking a person is the best way to do it."

"I don't think I just want to be told the answer ... Getting something explained to you and getting it shown to you is different from just getting told an answer. Like if I asked a teacher for help and they just told me the answer, I wouldn't be like: 'Oh that's great, thanks' ... The best teachers don't tell you an answer - they tell you how to find the answer yourself."

She makes an interesting point about how when she wants to do something on the computer she'd naturally try and use one of the applications that are already on the computer - even if it wasn't purpose built for the thing she wanted to do - rather than search for, download and install a new application from the Internet.

I also found it revealing that she wasn't aware that most help systems for applications have an index and a search facility.

She didn't like the idea of help videos, because she wouldn't want to sit through a whole video to find out how to do something.

Rocky the dog Finally, she's also the only person I know who's ever had anything good to say about the Microsoft Office Assistant dog. 

One of the software applications mentioned in the interview is:

painterXPainter Classic
Metacreations Painter Classic came bundled with a Wacom tablet I bought years ago. Used with a drawing tablet it was a very impressive bit of software. Corel bought Metacreations and the latest incarnation of that software is Painter X (i.e. version 10).

http://www.corel.com/servlet/Satellite/gb/en/Product/1166553885783

This is one of the paintings Martha created using Painter Classic, in 2003, when she was twelve:

AutumnTree 


 

Get in touch!

I’d love to know who’s listening, where you are and what you think of the podcast, so contact me at:

comments==AT==itauthor==DOT==com

Or just let me know you’ve listened in by putting a pin in the ITauthor map at:

http://www.frappr.com/itauthor

The music I play at the beginning and end of the show is by Amplifico. You can hear more of their music at Podshow.



Subscribe to the podcast:



RSS icon

http://feeds.feedburner.com/itauthor




iTunes_logo

Blubrry_logo

feedburner

Why not get emailed next time I publish a podcast?



Preview

 

Leave a comment



ITauthor podcast #20 – The Mallcast

November 16th, 2008

The voices in this podcast belong to: Graham Campbell and Alistair Christie.

Graham in the mall-10Nov2008

This extremely ad hoc podcast (we didn't plan to do one, but Graham suggest it and offered to buy me lunch, so it seemed like a good idea), was recorded in the food court at East Kilbride shopping centre. The photo shows Graham in the queue at the salad bar, trying to avoid being in the picture.

 

We talk about what we've been doing since our last podcast. Topics include:

  • ISTC Conference 2008
  • UA Europe Conference 2008
  • Is is worth going to tech writer conferences? What do you get out of it?
  • Why are people still talking so much about DITA?
  • Geoffrey Pullum and Grammar Nazism
  • "supercede" or "supersede"?
  • Roadmap announced for a DITA version of Flare
  • Benefits to customers and technical writers of hosted Web help

Recommended Web site: Language Log

Recommended podcast: Napoleon 101 Podcast
Napoleon101


Get in touch!

I’d love to know who’s listening, where you are and what you think of the podcast, so contact me at:
comments==AT==itauthor==DOT==com

Or just let me know you’ve listened in by putting a pin in the ITauthor map at:
http://www.frappr.com/itauthor

The music I play at the beginning and end of the show is by Amplifico. You can hear more of their music at Podshow.


Subscribe to the podcast:

RSS icon
http://feeds.feedburner.com/itauthor


iTunes_logo
Blubrry_logo
feedburner

Why not get emailed next time I publish a podcast?

Preview

 

Leave a comment



ITauthor podcast #19 – Three generations of computer users (Part 1)

November 9th, 2008

MargoChristie I wanted to find out how people of different generations use computers, what they use their computers for, how they use them and what they feel about computers and software generally. So who better to ask than three generations of women from my family.

In this, the first of a series of three podcasts, I talk to my mum, Margo Christie about why she decided - quite recently - to buy herself a laptop. She describes how she learned to use a computer and what she uses it for now.

 

 

The books mentioned in the recording are:


Get in touch!

I’d love to know who’s listening, where you are and what you think of the podcast, so contact me at:
comments==AT==itauthor==DOT==com

Or just let me know you’ve listened in by putting a pin in the ITauthor map at:
http://www.frappr.com/itauthor

The music I play at the beginning and end of the show is by Amplifico. You can hear more of their music at Podshow.


Subscribe to the podcast:

RSS icon
http://feeds.feedburner.com/itauthor


iTunes_logo
Blubrry_logo
feedburner

Why not get emailed next time I publish a podcast?

Preview

 

Leave a comment



ITauthor podcast #18 – ISTC Conference 2008

October 10th, 2008

GrahamC Graham Campbell talks to attendees at this year’s ISTC (Institute of Scientific and Technical Communicators) Conference in Nottingham.

First, Graham talks to Mike Hamilton from MadCap Software about recent and future software releases and some of the new features and improvements in Flare 4.

Andrew Jackson of Pacific Blue Solutions gave a presentation on information mapping. He gives an overview of what information mapping is all about, why it’s relevant for technical writers and how you go about learning how to use information mapping.

In the final segment of the podcast, Graham gets “an assorted bunch of tech authors” (John, Chris, Katja and Paul) to share their thoughts about the conference and to discuss technical authoring in general.


Get in touch!

I’d love to know who’s listening, where you are and what you think of the podcast, so contact me at:
comments==AT==itauthor==DOT==com

Or just let me know you’ve listened in by putting a pin in the ITauthor map at:
http://www.frappr.com/itauthor

The music I play at the beginning and end of the show is by Amplifico. You can hear more of their music at Podshow.


Subscribe to the podcast:

RSS icon
http://feeds.feedburner.com/itauthor


iTunes_logo
Blubrry_logo
feedburner

Why not get emailed next time I publish a podcast?

Preview

 

Leave a comment



^ back to top ^

Page 3 of 7«12345»OlderLast »