Say hello to JIRA Agile and JIRA Capture Learn More »

Archives for the tag: technical writing

How to Manage Complex, Versioned Content in Confluence

I'm speaking at RoadTrip 2014 Learn More »

This is a guest post from K15t Software, Atlassian Experts and makers of Scroll Office, Scroll Versions, Scroll PDF Exporter, and many other Confluence add-ons. If you manage complex content in Confluence, Scroll Versions is a must-have add-on for keeping your Confluence instance organized. With it, you can manage concurrent versions of pages or product documentation in one space, enhance content-reuse, improve SEO, and now publish to an existing Confluence space! We've taken all the customer

Continue reading »

The Atlassian technical writers and friends have just held our fourth doc sprint, and it was the biggest and best yet. We had sprinters sprinkled round the world. We worked on site in Sydney, San Francisco and Amsterdam. Remote sprinters joined us online via HipChat and the wiki. We wrote words, we wrote code, we solved chocolate anagrams. Confluence 4.3 just wouldn't be the same without our tutorials! Cool. So what's a doc sprint again? A doc sprint is an event where people get together to

Continue reading »

The Atlassian technical writers invite you to one of our famous choc fests – uh, doc sprints! This time we're targeting the Confluence developer documentation. Let's build some simple but lustworthy Confluence add-ons, and write them up so that other people can follow in our footsteps. A doc sprint is an event where some seriously cool people spend time together, building plugins and other add-ons, and crafting tutorials around them. This time it's happening in Sydney, San Francisco, Amsterdam,

Continue reading »

Getting feedback on the Atlassian product documentation

I'm speaking at RoadTrip 2014 Learn More »

This is a post written by Paul Watson, an Atlassian technical writer, as part of an ongoing series written by the technical writing team, exploring the latest techniques in technical communication. We’ll write about our projects, experiments and ideas, and we’ll share the techniques we use to give our customers the sweetest documentation in the world. Getting Customer Feedback There’s no question that getting feedback is a good idea – a law of nature even. Think survival of the fittest.

Continue reading »

Recently, I've redesigned of the Atlassian development tutorial that introduces developers to our software developer kit (SDK) . This is the second of a three-part series of blogs related to this project. Part 1, What is Your Tutorial's Funnel Conversion Rate introduced the assignment and the funnel conversion report I use to measure its success. In this part, I show you how to create and configure your own Google Analytics goal funnel so that you can measure a tutorial's funnel conversion rate on

Continue reading »

The latest assignment I've got calls for a redesign of the Atlassian tutorial that introduces developers to our software developer kit (SDK) .  This is the first of a three-part series of blogs related to this project.  In this part, I discuss the project goals, the research behind the redesign, and some metrics for measuring the current and future success of the tutorial. Part 2 documents a process you can use for creating a URL funnel.  Part 3 provides some tips and tricks learned during the

Continue reading »