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 #34 – Testing testing 123

May 23rd, 2010    4 Comments

Richard PatersonTest Manager Richard Paterson joins Graham Campbell and me over lunchtime sandwiches in a rather noisy office to talk about software testing.

Technical writers in a software development department often feel like third-class citizens, with programmers as the top-dogs and testers being granted second-class status. This engenders a certain camaraderie between fellow poor relations, testers and tech writers, filling, as they do, roles that are sometimes viewed as subordinate or auxiliary to the majority party within the development department. The work of testers and tech writers often starts at around the same time, and both roles can be subject to "ship early" pressure to keep the time available to them to a minimum.

But like tech writers, testers - rightly - believe that what they do is a crucial, if undervalued, function for the creation of quality software products.

Amongst other things, I ask Richard:

  • What is software testing?
  • Why do we need testers? (Can't programmers just test their own code?)
  • What's the difference between: unit tests, integration tests, regression tests, functional tests, user acceptance tests, lean testing ...?
  • How do testers and programmers get on? (Don't programmers get really irritated by testers finding bugs in software the programmer thought was working fine?)
  • Why can't we introduce automated testing and save on all the money we're paying all those testers?
  • Are technical writers as useful to testers as testers are to technical writers?
  • Who'd be a tester?

Got any thoughts on the matter? Leave a comment below.

For something completely different, have a read of Richard's blog:
ROCKETBOOTKID AND BOOSTERBOY'S PALACE OF RIGHTEOUS JUSTICE.


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 Feed RSS Feed   Add to del.icio.us Add to del.icio.us   Add to del.icio.us Add to Digg   Add to iTunes Add to iTunes   Add to Zune Add to Zune   Add to Google Add to Google

ITauthor.com/podcasts – the technical writing podcast

Comments

  1. User Gravatar William Echlin said:

    May 26th, 2010 at 10:06 am (#)

    This is so true. As a tester I’ve always felt more camaraderie with my technical writer colleagues. Developers tend to bask in all the glory whist testers and writers end up feeling like they ought to be worshiping at the developers feet. I think it’s fair to say though that both tester and technical writer roles bring a significant amount to each other’s roles. Testers usually have a far better understanding than the developer of how the whole system hangs together. Hence the tester is usually a good resource for the technical writer. Likewise the technical writers I’ve known have been very good at finding bugs. And the technical writer is certainly better at writing up a good bug report than most testers. From the testers perspective though, I’d turn that last question round. I’d ask “Who’d be a technical writer?”

  2. User Gravatar Breaking Things as a Form of Creativity | I'd Rather Be Writing said:

    July 1st, 2010 at 2:28 pm (#)

    [...] Author’s latest podcast, Testing testing 123, dives into testing. Rather than just commenting on testing from a technical writer’s point [...]

  3. User Gravatar shankar said:

    August 20th, 2010 at 12:35 pm (#)

    1)sir ,plz tell me what is the major difference between technical writer and software tester?
    2)what is the difference between content editor and technical editor?
    plz reply to my mail id

    a.sankar.86@gmail.com

  4. User Gravatar itauthor said:

    August 27th, 2010 at 7:54 pm (#)

    1) What is the major difference between technical writer and software tester?
    I'm tempted to say a tech writer writes about software whereas a tester tests it. Essentially a software tester is checking to make sure the software works the way its supposed to before a release ships. The technical writer's job is to help people use the software - partly by explaining what you can do with the software, but most of the time by writing procedural topics that expain how to complete a specific task, so that when the user can't figure out from the user interface alone how to do something they can find out from the documentation (typically via some sort of online help).

    2) What is the difference between content editor and technical editor?
    I never worked anywhere that used those names. "Editor" isn't a common role in software companies. Its more like a role you'd get in publishing. I used to work for a book publisher and we had all sorts of different types of editors: I was a "desk editor" for a long time. But, just going by the names themselves, content editor suggests this role checks the content to make sure reading level is pitched appropriately, there's the right level of detail, the presentation of the information works well, the grammar is correct, it's appropriately illustrated, it's well structured and easy to find information, and so on. The technical editor, on the other hand, will be checking the technical accuracy of the information.

    That's my guess anyway. Like I say, these aren't roles I'm familiar with.

Leave a comment

 

ITauthor podcast #33 – A history of RSS

March 20th, 2010    1 Comment

image Ever wondered how news and blog posts appear in Google Reader or how podcasts get onto your iPod? It's largely thanks to something called RSS.

What does RSS stand for? Who invented it? What happened along the way? This podcast tells the story of RSS, from its earliest beginnings in 1995, through the births of XML, blogging and then podcasting, to the present day.

For the full script of this podcast, with lots of lovely pictures, look no further than: http://www.itauthor.com/2010/03/16/a-history-of-rss/
This page also has a full list of references for all the quotes and clips I used.

No sooner had I recorded this podcast than it was out of date. Right at the end I describe Tim Bray as leaving Sun Microsystems. He has since taken the position of "Developer Advocate" at Google. I also said that the last Daily Source Code appeared in February 2009. That was true at the time but yesterday Adam Curry resurrected it with DSC822.


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 Feed RSS Feed   Add to del.icio.us Add to del.icio.us   Add to del.icio.us Add to Digg   Add to iTunes Add to iTunes   Add to Zune Add to Zune   Add to Google Add to Google

ITauthor.com/podcasts – the technical writing podcast

Leave a comment



ITauthor podcast #32 – Unscripted screencasts and Flare extensibility

January 23rd, 2010    1 Comment

For this edition of the ITauthor podcast, I just turned the microphone on and started talking. So if ums and ahs annoy you, this podcast probably isn't for you!

I ruminate over whether it's acceptable to use unscripted, unpolished screencasts in published documentation. Does it matter if you stumble over your words once or twice, um and ah, and have to correct your typing as you go along? Does the unscripted approach add an element of authenticity and make the whole thing more realistic and believable?

I also talk about the functionality I've been adding to our Madcap Flare projects to provide alternatives to the built-in glossary popups and expanding sections.

Finally I scan through my iPod and make a podcast recommendation. The podcast I chose was Speechification.
Website: http://speechification.com/
Podcast: http://feeds.feedburner.com/speechification 

 


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 Feed RSS Feed   Add to del.icio.us Add to del.icio.us   Add to del.icio.us Add to Digg   Add to iTunes Add to iTunes   Add to Zune Add to Zune   Add to Google Add to Google

ITauthor.com/podcasts – the technical writing podcast

Leave a comment



ITauthor podcast #31 – Matthew Ellison looks forward to the UA Europe Conference 2009

May 16th, 2009

MatthewEllison

Matthew Ellison runs his own UK-based training and consulting company, specializing in user assistance design and technology. He coordinates the annual UA Europe Conference and is himself a popular speaker at conferences and training events around the world. He also regularly publishes articles and reviews on user assistance.

In this edition of the ITauthor Podcast I talk to Matthew about the UA Europe Conference.

 

 

 

 

We discuss:

  • the number of countries from which delegates attend the conference
  • what it’s like being the organiser of a large conference for technical communicators
  • how can delegates justify the budget to attend the UA conference in these difficult economic times
  • the sessions and speakers we can look forward to at this year's conference
  • the No.1 issue affecting technical writers today
  • trends or changes technical writers ought to be aware of
  • what keeps Matthew busy when he’s not organising and running the UA Europe Conference

Talking about the “good enough” philosophy for user assistance, Matthew says:

"There's a fine line between doing documentation that's good enough and not being professional, and I certainly would never want to put something in front of a user that I didn't consider a professional piece of work."

Find out all about the UA Europe Conference at: http://www.uaconference.eu.

 


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 Feed RSS Feed   Add to del.icio.us Add to del.icio.us   Add to del.icio.us Add to Digg   Add to iTunes Add to iTunes   Add to Zune Add to Zune   Add to Google Add to Google

ITauthor.com/podcasts – the technical writing podcast

Leave a comment



ITauthor podcast #30 – Being a technical writer

May 14th, 2009

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

This time round – recorded over Skype – Graham and I discuss:

  • “technical author”, “technical writer” or “technical communicator”
  • being forced out of technical writing by personal economics
  • why contractors are more productive than permanent documentation staff
  • an occasion where the tech writer was the closest thing to a Subject Matter Expert in an application development team
  • tech writers being considered “the lowest of the low”
  • why management find tech writers the easiest people to “let go”
  • using voiceovers rather than written callouts in videos
  • is documentation sometimes really remedial work on a bad user interface?
  • what do we actually need to document in an online help system?
  • being proud of the work we do

 

Ed and EJ Miller

StoryCorps recording in this podcast

This episode of the podcast ends with a StoryCorps recording of Ed Miller talking to his son EJ. This audio was provided courtesy of StoryCorps. Please visit www.storycorps.org for more details and, if you like what they do, please consider making a donation to help keep the StoryCorps mobile units on the road.

The part of this recording that I really identified with was where he says:

We go to the mall nowadays, me and Mom, and I see dads walking with their sons or daughters, holding their hands, and I tell you, my heart aches for the days when I used to do that …

 


Podcast recommendations:

writing-show-logo

The Writing Show  –  http://www.writingshow.com/index.html 

(Graham refers to the recording I made for the Writing Show.)

StoryCorps-Airstream 

The StoryCorps Podcast – http://www.storycorps.org/listen/podcast

 

Application recommendations:

skype 

Skype – http://www.skype.com

snagit9 

Techsmith Snagit – http://www.techsmith.com/screen-capture.asp 


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 Feed RSS Feed   Add to del.icio.us Add to del.icio.us   Add to del.icio.us Add to Digg   Add to iTunes Add to iTunes   Add to Zune Add to Zune   Add to Google Add to Google

ITauthor.com/podcasts – the technical writing podcast

Leave a comment



^ back to top ^

Page 1 of 712345OlderLast »