Documenting from afar
I’ve been in San Francisco for the last few days, working in the Atlassian office here and meeting my SF colleagues. My visit has made me think about the pros and cons of long-distance communication, the technology we use to make it happen, and most of all just how good it is to meet people face to face.
Atlassian has offices in Sydney, where I’m based, and in Amsterdam, Japan and San Francisco. Sydney is the largest office, followed by San Francisco. We also have a team of developers in Poland, working on the Atlassian IDE Connectors for Eclipse and IntelliJ IDEA.
As a technical writer, I document some products that are developed in Sydney, some that are developed in San Francisco and even some where the development team is in Poland. Recently we have also partnered with Tasktop (of Mylyn fame) to develop the Atlassian Eclipse Connector, a neat tool which lets developers work with their JIRA issues, Crucible code reviews and Bamboo builds directly in their development environment. I’m documenting the connector, which means I’m working with developers in Vancouver too!
Documenting from afar does work
So, long-distance communication is a must. And actually, it’s not bothersome. Many aspects are quite enjoyable, especially the technology. We have video conferencing that’s kind of fun, a wiki (Confluence) that works wonders, an issue tracker (JIRA) that works like a dream, Twitter, instant online chat… You name it, Atlassian tries it.
Sometimes I work from home, and the developers on the ground floor in Sydney don’t even realise I’m not at my desk on the first floor in Sydney😉 So what difference do a few more thousand kilometres make?
But it’s just great to meet the people in meat space
I’ve discovered that many people look nothing like their TV images!
I document many of the development-focused products, like the Plugin Framework and the Shared Access Layer. The development teams for those are split between Sydney and SF. I’m also just starting the documention for the new Atlassian Gadgets and Dashboards. (See my earlier blog post.) Most of the development team is in SF. In the few days I’ve been here, I’ve created a new documentation space for Gadgets and Dashboards. The space is still just a skeleton, but I had the chance to review that skeleton while in the same room as the developers. Awesome.
- I joined the daily standups.
- I experienced the dynamics of the development team. All dev teams are different, as we technical writers know. We need to make sure we fit in as much as possible, to optimise the use of our time and the developers’ time. And to have fun.
- I met the people in the support, marketing and technical sales teams, who give so much input into and feedback on the documentation.
- I spoke to everyone else in the office, and verified that they actually look something like their avatars on the extranet, but only something like them.
- People took me round their favourite parts of the city, collected me at lunch time to sample a Mission Burrito, took me to some very up-market restaurants, and just showed me what a great place SF is.
- They laughed at my jokes.
And I was awake for the Eclipse Connector launch
To top it all, the new Eclipse Connector was launched on Monday, my first day in SF. It was useful to be in more-or-less the same time zone as the Tasktop development team in Vancouver and the people trying the connector for the first time at EclipseCon. I was able to respond quickly to requests for troubleshooting guides and FAQs, update the documentation and get the developers to review it on the fly. Fun and very productive.
Farewell fair San Francisco
And thank you to the Atlassian SFers, who gave me such a very warm welcome. This is a view of the city, taken from Twin Peaks just before sunset. The wide road going down the middle is Market Street:
If you’d like to see more pictures of and words about my trip, drop by the Travelling Worm’s blog. He’s my bookmark and he keeps a fairly faithful chronicle of my travels😉
Tomorrow I’m heading off to Seattle (where it rains) for the WritersUA conference. I’m looking forward to meeting many other technical communicators there, including some that I know only from their blogs and tweets. More long-distance communication about to be converted to face-to-face meetings. See you there!
Long-distance or f2f?
I’m really happy with the long-distance communication. And I’m also very lucky that I had this chance to meet the SF teams face to face. I wonder how many technical writers are located some distance from their development teams. How about you, and does it work for you too?
Posted on 27 March 2009, in atlassian, technical writing and tagged atlassian, Confluence, documentation, JIRA, San Francisco, technical documentation, technical writing, wiki, wikis. Bookmark the permalink. 5 Comments.