WritersUA 2009 – Enterprise documentation on a wiki

This week I’m attending the WritersUA 2009 conference in Seattle. Yesterday it was my turn to present a session. My talk was all about using a wiki for technical documentation. No, really? 😉

My  approach was to introduce a number of topics that are relevant when you’re writing technical documentation on a wiki. I gave an overview of each topic and referred to my notes in the handouts. The slides and the handouts are attached to this blog post. Feel free to download them and use them to track down more information.

My main topics in this presentation were:

  • An introduction to myself and my wiki — Confluence version 2.10
  • Agile development — how a wiki is useful in an agile environment
  • Workflow and tracking — a technical writer’s bread and butter, and how they work on a wiki
  • Structure and chaos — a wiki may be seen as a chaotic environment, but we technical communicators need to bestow some structure on the documentation
  • Release management — how your wiki documentation can relate to specific versions of your product
  • Steering wiki development — how you as a technical writer can influence the features and development of wikis

I hope the slides and accompanying notes prove useful:

This was the first time I’ve ever given a presentation at a conference, or anywhere else apart from team demonstrations. I had a bit of a battle with an iteratively-drooping microphone. But apart from that, the presentation went smoothly.

A big thank you to Joe Welinske and all the confererence organisers and attendees. I was rather nervous, but your warm welcome made it much easier and much more enjoyable than I was expecting. Thank you also especially to Joe for inviting me and giving me the opportunity to attend the conference and to visit the US for the first time.

About Sarah Maddox

Technical writer, author and blogger in Sydney

Posted on 2 April 2009, in Confluence, technical writing, wiki, WritersUA and tagged , , , , , , , , . Bookmark the permalink. 1 Comment.

  1. Wow, thanks. Bingo, exactly the sort of information I have been seeking. Thanks!

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: