Report from Write the Docs Sydney
This week we hosted the first ever Write the Docs meetup in Sydney. It was great to see so many familiar faces and to meet so many new people too.
The Sydney meetup
We had 22 attendees at the inaugural Sydney meetup. The venue was the Google offices in Pyrmont.
Swapnil was an excellent host. Between the two presentations (see below) he asked attendees to introduce themselves and say what they liked most about technical documentation or being a technical writer.
What attendees like about technical documentation / technical writing:
- I like to explain things.
- The scope of technical documentation extends all the way from consumers to developers.
- I like editing a doc when someone complains about it – that means they need it.
- I like to help things go smoothly.
- I’m married to a technical writer.
- Technical documentation says exactly what it means. It cuts out all the fluff, even when describing an error in the product.
- I get to do problem solving in a creative environment.
- I like the ability to make the documentation a tool that someone can use rather than just read.
- Technical documentation captures stuff before it’s lost.
- I truly enjoy the research that goes in before writing the docs. Discovering bugs!
Presentation: Integrating more closely with software product teams
Craig Simms, from Campaign Monitor, presented a talk on how technical writers can integrate more closely with software teams. Campaign Monitor works off an agile development process. As processes change, the technical writing team must change to keep up.
Craig’s presentation was amusing and engaging. He told the story of how technical writing started at Campaign Monitor as a community building role, but it quickly became apparent that it was a core technical writing role. Quite quickly, the two writers in the company felt that their role description and placement in the company didn’t reflect the value that technical writers bring to an organisation. They decided they needed to join a product team.
Craig described the two years of adventure he and his co-writer have had, attempting to get into a product team. They’ve not yet succeeded, Craig said with a laugh, but he gave a zestful account of the lessons learned, and the steps they’ve taken towards that goal. One of the questions that’s arisen is this: Is product the right place for technical writers? An attractive alternative is to be part of the marketing team.
This quotation from Craig’s presentation in particular rang true with me:
Define your own value, and never stop telling people.
Here’s the recording of Craig’s presentation:
Presentation: Wrapup of Write the Docs Prague
Swapnil Ogale presented his summary and take-aways from the recent Write the Docs Prague conference.
Swapnil talked about these topics:
- Why he attended the Prague conference.
- Attendee demographics – he showed a lovely picture of the venue and participants.
- Range of topics covered – wide, including fiction and health!
- A deep dive into 2 presentations he found most useful.
- The unconference part of the event – spontaneous sessions on what people wanted to talk about.
- Key takeaways from the conference.
An interesting statistic:
70% of participants are working on dev docs, APIs and UI text.
Here’s the recording of Swapnil’s presentation:
Where next for Write the Docs Australia?
I’ve been lucky enough to attend both meetings of the Write the Docs Australia group. Perhaps I can keep a good thing going and join the third, wherever it may be. Brisbane, anyone? 🙂