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 is part of the Write the Docs Australia group, founded by Swapnil Ogale. This was the Australia-wide group’s second meeting, after the kickoff in Melbourne in September.

The Sydney meetup

We had 22 attendees at the inaugural Sydney meetup. The venue was the Google offices in Pyrmont.

Write the Docs Sydney

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.

Write the Docs Australia

  • 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.

Write the Docs Australia

  • 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 Simms, Campaign Monitor

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 Ogale, Write the Docs

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? 🙂

Advertisements

About Sarah Maddox

Technical writer, author and blogger in Sydney

Posted on 5 November 2016, in technical writing, Write the Docs and tagged , , , . Bookmark the permalink. 3 Comments.

  1. Charlotte Brogden

    Looks amazing! Joining immediately.

  2. Brisbane? Oh yes, I’m in!

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 )

Twitter picture

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

Facebook photo

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

Google+ photo

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

Connecting to %s

%d bloggers like this: