Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me

MARRYING TWITTER WITH USER DOCUMENTATION

March 18, 2011 by RDesprez 11 Comments

I just got back from the Writ­er­sUA tech­ni­cal writ­ing con­fer­ence yes­ter­day in Long Beach, Cal­i­for­nia. As I expect­ed, I attend­ed many real­ly inter­est­ing sessions.

Here’s one great idea. Sarah Mad­dox, an Aus­tralian tech­ni­cal writer, works at Atlass­ian, the com­pa­ny that devel­ops JIRA (bug and issue track­ing soft­ware) and Con­flu­ence (web-based cor­po­rate wiki soft­ware). She and her team cre­at­ed wiki doc­u­men­ta­tion that com­bines tra­di­tion­al tech­ni­cal doc­u­men­ta­tion, social media, and links to relat­ed blog posts. Here’s a screen capture:

 

This screen cap­ture shows a sam­ple of Atlassian’s wiki doc­u­men­ta­tion, which includes a Twit­ter stream at the bot­tom of the page.

If users tweet on a giv­en top­ic, they’re reward­ed by giv­en an online badge that they can add to their own blogs or social sites.

Sarah and her col­leagues at Atlass­ian have pulled off a rare feat—content that mar­ries tech­ni­cal doc­u­men­ta­tion, social media, and even viral mar­ket­ing. Because users who decide to tweet are offered an online badge, oth­ers might see the badge on anoth­er site and then tweet as well, which could lead to more and more users con­tribut­ing to the dia­log via Twitter.

This project won the most inno­v­a­tive idea at the Writ­er­sUA “peer show­case.” I think it’s a great idea and well deserved.

Filed Under: Online Collaboration, Robert Desprez | Vancouver technical writer | Blog, Social Media, Web 2.0 Tagged With: online documentation, social media, Twitter

About Robert Desprez

I have worked as a Vancouver technical writer for more than 20 years, working at some of British Columbia's largest high-tech firms. I have served in leadership positions for the Society for Technical Communication and have worked as a writing instructor at Vancouver's Simon Fraser University.

Robert Desprez Follow 1,191 242

Vancouver Technical Writer. Former Instructor at Simon Fraser University. Dog Lover. Coffee Drinker. Tennis and Piano Player.

robert_desprez
robert_desprez avatar; Robert Desprez @robert_desprez ·
17 Nov 1990511045618889117

Image for twitter card

Jeff Bezos reportedly to co-lead AI startup called Project Prometheus

Move marks first time the Amazon founder will have an operational role at a company since 2021

www.theglobeandmail.com

Reply on Twitter 1990511045618889117 Retweet on Twitter 1990511045618889117 0 Like on Twitter 1990511045618889117 0 Twitter 1990511045618889117
robert_desprez avatar; Robert Desprez @robert_desprez ·
13 Nov 1988989060904546771

Why long-running tasks autonomously carried out by agentic AI aren’t the future of doc work, and...

As AI agents become more capable, there’s growing eagerness to develop long-running tasks that operate autonomously ...

idratherbewriting.com

Reply on Twitter 1988989060904546771 Retweet on Twitter 1988989060904546771 0 Like on Twitter 1988989060904546771 0 Twitter 1988989060904546771
robert_desprez avatar; Robert Desprez @robert_desprez ·
5 Nov 1985944193135755385

Image for twitter card

Federal budget dedicates over $1B to boost Canadian AI and quantum computing | CBC News

Prime Minister Mark Carney’s first budget proposes providing more than $1 billion over the next five years to bu...

www.cbc.ca

Reply on Twitter 1985944193135755385 Retweet on Twitter 1985944193135755385 0 Like on Twitter 1985944193135755385 0 Twitter 1985944193135755385
robert_desprez avatar; Robert Desprez @robert_desprez ·
4 Nov 1985736843468685471

Gen Z workers shunning the career ladder is more of a reaction to the behaviour of companies /via @globeandmail

Image for twitter card

Gen Z workers shunning the career ladder is more of a reaction to the behaviour of companies

These workers are looking at the path to the corner office with skepticism, which makes sense given that the eco...

www.theglobeandmail.com

Reply on Twitter 1985736843468685471 Retweet on Twitter 1985736843468685471 0 Like on Twitter 1985736843468685471 0 Twitter 1985736843468685471
Load More

Recent Blog Posts

  • Using ChatGPT to read smarter
  • ChatGPT: The AI-powered proofreader
  • Four ways Confluence could be better
  • First impressions of MadCap’s purchase of IXIASOFT

About Me

Robert Desprez I have worked as a Vancouver technical writer for more than 20 years, working at Kodak, Boeing, Teck Resources, and FortisBC. In addition, I have worked as a writing instructor at Simon Fraser University in Vancouver.

Contact Me

Robert Desprez Com­mu­ni­ca­tions Inc.
North Van­cou­ver, British Columbia
Canada
Phone: 604–836-4290

  • Email
  • LinkedIn
  • Twitter

Copyright © 2025  · Robert Desprez Communications Inc.