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:
- Enterprise documentation on a wiki — slides plus notes
- Enterprise documentation on a wiki — slides only
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.
Posted on 2 April 2009, in Confluence, technical writing, wiki, WritersUA and tagged agile, atlassian, Confluence, documentation, technical documentation, technical writing, wiki, wikis, WritersUA. Bookmark the permalink. 1 Comment.