Twitter as a medium for release notes

In the last couple of weeks, I’ve been trying an experiment — using Twitter as a medium for release notes. It’s been interesting, so I thought you’d like to read about it. We could use Twitter in other ways related to technical documentation too, such as hints and tips or FAQs. Let me know if you’ve done that already!

I’m going to start with a short introduction to Twitter, mentioning particularly the aspects that I found useful when tweeting release notes. If you’re already a twitterologist, you may want to skip that bit. Then I’ll describe how we’ve used Twitter as a method of communicating the highlights of our release notes.

An introduction to Twitter

Twitter is a service that allows you to send short messages to anyone who is interested in reading them. You can sign up for a free account at Then just type in your message where Twitter asks somewhat abruptly “What are you doing?” and click “Update”. Bob’s your uncle, you’ve tweeted.


“Short” messages? Oh yes, very short, especially in technical writing terms 😉 The maximum length of each message, or tweet as they’re called, is 140 characters. There’s an art to saying something meaningful in such a short message. Especially when the message is a release note highlight. So be warned, you may spend quite a bit of time tailoring your tweet.

The tweet below illustrates a number of conventions tweeters use to make as much as possible of those 140 characters. I’ll tell you more about the conventions later, and how we can use some of them in our tweeted release notes.

Twitter as medium for release notes

Twitter as medium for release notes


According to some reports, there are approximately 10 million people using Twitter, and its growth rate is around 1,382 (more than a thousand) percent per year. (See Web Strategy blog.) That’s an awful lot of tweets to read. So what you do is “follow” people. Twitter will send you the tweets of the people that you are following. Similarly, other people will follow you so that they can read your tweets.

You can restrict the visibility of your tweets to only people you’ve allowed to see them. You can also block specific people from following you.

RT (retweet)

What I’ve found extremely interesting in Twitter is the conventions that have sprung up as people start using it for wider and more specific purposes. “Retweeting” is one of those conventions. If you like what someone said and want to spread the word while attributing the goodness to the original tweeter, you can “retweet” their message. Simply add the letters “RT” into your message, copy the original text, and tweet away. What’s more, there are Twitter clients that do this for you automatically. I’ve mentioned some clients later in this blog post.

In the tweet illustrated above, Alister Scott has retweeted one of my tweets. Thank you Alister 🙂

@ replies

When you want to reply to someone, or refer to them in such a way that they’ll know you’re doing it, include an “@” and the person’s Twitter username. For example, “@sarahmaddox”. Many clients provide a “reply” option that does this for you. Clients also have a separate column or tab showing the @ replies directed to you, so that they don’t get lost in the main stream of tweets.

#-tags and search

Another very useful convention is the #-tag. Let’s say you are sending a message about a particular subject, and you think other people would like to read and to send tweets about that subject on an ongoing basis. This may be for fun or for a more serious purpose. Just think up a keyword, prefix it with a “#”, and include it in your message.

In the tweet illustrated above, I used “#googlewave”.

Here are the realtime results for a Twitter search on “googlewave”. And here’s what people are saying right now about “funnywords”.

Other people will start using your keyword, and they will also search Twitter for other messages that contain the same keyword. Many Twitter clients will do the search for you. Twitter search returns results from all tweets sent by anyone in the whole wide world, not just the tweets sent by people you are following.

Combined with the #-tag, this makes a very interesting combination for our tweeted release notes.

Short URLs

A URL can be very long, consuming far too many of those valuable 140 characters. Luckily there are a few services on the web that will shorten your URL for you. The service gives you a short string that you can include in your tweet (or in an email, or a blog post, etc). When other people click the short string, they are bounced back to the service’s URL and then forwarded on to your original URL. Examples of such a service are, and

In the tweet illustrated above, I used

Twitter clients

One of the most magical aspects of Twitter is that you don’t have to go to to use it. There are a number of Twitter clients that add useful functionality to your desktop and make it possible to tweet from your phone too.

The clients have built in extra functionality as the Twitter culture evolves:

  • The use of a #-tag triggers an auto-link. If you click the link, it launches a Twitter search.
  • The use of “@username”, e.g. “@sarahmaddox”, links to the user’s Twitter profile e.g. mine.
  • Clients like TweetDeck provide sophisticated search functionality. You can define search criteria using AND, OR, quotes, etc and build a “permanent” search that notifies you whenever a new tweet arrives matching your criteria. The matching tweets can be from anyone, so they’re not restricted to your friends.
  • Clients supply an easy way of shortening URLs. Some clients do it automatically, via a specific URL-shortening service like, or Other clients offer you a range of services to choose from.

I have TweetDeck running on my Windows XP desktop and on my Windows Vista laptop. It’s built on Adobe Air and has a lot of useful features including a sophisticated search capability. Here’s what it looks like. In the left-hand column are some tweets from people I’m following. Next are replies sent to me (via “@sarahmaddox”). The two right-hand columns are specific searches I have set up. All this is configurable, including the order of the columns:

Twitter as medium for release notes

Twitter as medium for release notes

TweetDeck gives a handy notification when new tweets arrive from people you are following, or as replies to you, or that match your search criteria:

Twitter as a medium for release notes

Twitter as a medium for release notes

Want to read and send tweets from your phone? Well, you can. On my iPhone, I have both Twitterific and TwitterFon. I prefer TwitterFon — see screenshot further down this blog post.

You can also send tweets to Twitter via SMS. That’s what I did before I got the iPhone. So at least you can tell people what you’re having for dinner, even if you can’t read what they’re having until you get back to your computer 😉

Tweeting our release notes

So, how can we make use of all the above features and conventions to use Twitter as a medium for our release notes?


To emit a tweet per major highlighted point in the release notes, to include a link to the release notes and to provide a way for tweet consumers to see a collection of such related tweets.

A consideration

In general, people read only the last few minutes’ worth of tweets. It’s not like email, where people make an effort to at least scan their inbox when they’ve been out of touch for a few hours or days. We need to make sure our design catches as many people as possible, and shows them where to go for more information if they want it.

What we did

Here’s the plan of action:

  • Use Atlassian’s corporate Twitter account, rather than a personal account. Release notes are in a weird place, partly technical documentation and partly marketing information. People follow Atlassian’s Twitter ID and know what to expect from it i.e. company news. So they’re not dismayed to receive marketing-type information.
  • Use a #-tag to tie the tweets together. This is the most exciting bit. It provides a way for tweet consumers at any time to see a collection of such related tweets. A collection of release highlights is… the release notes. Ta da ♪ ♫
  • Use a shortened URL (e.g., or to link to the release notes themselves, so that people can read the full details if they want to.
  • Don’t send out all the tweets at once. This would spam people, and a number of other people would miss out on your news because they’re not reading their tweets at the time. Instead, send out two tweets a day, the second about four hours after the first, for two or three days.
  • Try it out for three or four product releases, then assess feedback and decide whether to continue.

The results

So far, I’ve tweeted about two of our product releases: the Atlassian Eclipse Connector 1.0 and Confluence 3.0.

For the Eclipse Connector 1.0, I used a tag of “#EclipseConnector10”. (#-tags are not case sensitive, because the Twitter search is case agnostic.) Here’s a screenshot of the resulting search on the web UI, at a particular point in time:

Twitter as a medium for release notes

Twitter as a medium for release notes

In the above screenshot, you can see the format we’re using for each tweet: the text of a highlight from the release notes, plus the #-tag (“#EclipseConnector10”) plus the short URL (“”). Here’s the full content of one of the tweets:

Manage your Crucible code reviews via Eclipse Mylyn’s task-focused interface #EclipseConnector10

Of course, the search may or may not show something quite different if you click it now.

What’s interesting is that I tweeted using the Atlassian account (the tweets with the dark blue icon of a dude holding up  slice of the globe) and other people retweeted or just repeated the tweets. ‘Coz they liked them. Those are the entries with “RT” in the above screenshot.

For the Confluence 3.0 tweets, I used the tag “#Confluence30”. Here’s a screenshot of the resulting search on the web UI, at a particular point in time:

Twitter as a medium for release notes

Twitter as a medium for release notes

And here’s a screenshot showing the resulting search via TwitterFon on the iPhone:

Twitter as a medium for release notes

Twitter as a medium for release notes

And you can check what the search yields now.

Nothing can go wrong go wrong go wrong

Heh heh. Take a close look at the two screenshots above. One person “hijacked” our #Confluence30 tag to communicate a problem he had when upgrading to the new version of Confluence, and the workaround for the problem

Of course, it was totally foreseeable that people would tweet problems as well as praise, and would include “our” #-tag in their tweets. Nothing is sacred on Twitter. We decided it would be interesting to go ahead and see the sort of response we get. After all, people are saying all sorts of things about us all the time, on and off Twitter.

The iPhone screenshot above shows the same person’s problem tweet, plus another person who was letting people know about a particular feature in the Confluence release (Twitter-like status updates).

It’s been a fun and interesting experiment.

Other uses of Twitter

People are getting very creative with Twitter. Wikipedia lists some of the unusual situations where Twitter has proved useful.

As technical writers we can probably think up a gazillion ways to use Twitter. We could tweet hints and tips, or even FAQs if we’re super wordsmiths, using the #-tags and shortened URLs much as I’ve shown above. Have you tried this or anything similar?

About Sarah Maddox

Technical writer, author and blogger in Sydney

Posted on 8 June 2009, in atlassian, technical writing and tagged , , , , , , , , , , . Bookmark the permalink. 18 Comments.

  1. I’m so glad you posted such a detailed process with methods that others can replicate! At the STC Summit I encouraged people who came to my session to experiment with Twitter – and here you go, doing it! I’ll direct people to this post for sure. Thanks for writing this up.

  2. A couple of people have replied via Twitter (as is appropriate 😉 ) to say that they’re also posting releases via Twitter:

    Guy Fraser’s tweet.
    Tobias’s tweet.

  3. A very useful and cutting-edge post. Very inspirational. I never thought one could use Twitter for this purpose. I’ll share this link on my own blog. Thank you.

  4. Hey Sarah,

    Great post esp for those just starting to think about what Twitter does, and can do. Thanks!

    Last year, we started using Twitter in similar ways – tips, new features, and updates about team activities – with our Blueprint product (follow at

    Being in the cloud, the product lends itself easily to embedding tweets directly into the app. It gets more interesting when you want to embed tweets into the context of behind-the-firewall apps. We plan to explore this stuff in the near future. And, of course, Google Wave:) As we progress, I’ll blog about our process and the technical implementation.

    I enjoy your posts, keep ’em coming!

    – lisa

    • Hallo Lisa

      Great comment! Based on your comment, and also on the Twitter responses from other people, there are quite a number of people using Twitter to announce release notes. I think adding the release-specific #-tag (e.g. #Confluence30) adds a bit of extra pizazz, because people can use it to see a list of tweets about that particular release.

      Your point about embedding tweets directly into the app is awesome! And yes, when behind the firewall it’s very interesting. You could supply the functionality to allow your customers to embed their own tweets or other micro-blogging messages, assuming they are using an internal micro-blogging server too. I’ll be very interested to read your blog posts. Your blog feed is one of those I follow every day 🙂

      Cheers, Sarah

  5. I thought this was an extremely useful article and you addressed one of the key questions for me. It has to do with the issue of communicating the updates by setting up a corp account on twitter. I guess its a balance between the marketing team and the tech team?

    I think re-tweets are an invaluable tool and it lends itself nicely to a word of mouth (WOM) campaign for the release notes.

  6. Hallo Peter

    Heh, I love the name of your website, “Our Man in Shanghai”! The logo is pretty cool too.

    I completely agree with you about the value of re-tweets. When other people re-tweet you, it’s an endorsement that their friends respect.

    The balance between marketing and the tech team is interesting. At Atlassian, our corporate Twitter account is open for any staff member to use. It’s a trust thing. Most of the tweeting is done by marketing.

    Release notes are an interesting case in themselves, even when not on Twitter, because they sit a bit uncomfortably between the tech and the marketing spheres. We haven’t yet made the decision about whether the tech writers will continue tweeting the release notes, or marketing will take it over. The next release of Crowd 2.0, due shortly, is the final one in our pilot. Then we’ll discuss and decide our next steps.

    Thanks for your comment!

  7. Good news! The tech writing team held a confab today. We like this idea, so we’ll go ahead with tweeting the release notes via Twitter.

    FYI: You can get stats from and (RIP dear about the number of click-throughs from your shortened URL. Here are the stats for the tweeted release notes we’ve done so far:

    IntelliJ Connector 2.1:
    Total clicks: 181
    Locations: United States 72; Australia 33; Other 19

    Confluence 3.0:
    Total clicks: 2,264
    Locations: Germany 1,429; Other 452; United States 165

    Eclipse Connector 1.0:
    Total clicks: 279
    Locations: United States 96; Other 59; Australia 42

    Crowd 2.0:
    Total clicks: 444
    Locations: United States 37; Other 383; Australia 24

  8. Here’s a hint: When drafting your tweets, hold a “Tweet-a-Choc” with the dev team, product manager and anyone else interested. Basically, you all sit around a table with mugs of hot chocolate and think up the tweets, based on the release notes 🙂

  1. Pingback: How to Use Twitter to Share Software Release Notes | Technical Communication Center

  2. Pingback:   Weekly links roundup by Communications from DMN

  3. Pingback: Twitter Guidelines from UK Government | just write click

  4. Pingback:   Microblogging for quick tips by Communications from DMN

  5. Pingback: How to Bring Web 2.0 to User Assistance (and Vice Verca) « Technical and Marketing Communication: Content for a Convergent World

  6. Pingback: Focus on Twitter for Technical Documentation – 26th Edition | Tweet Cash

  7. Pingback: How Documentation Professionals Like Technical Writers Can Use Twitter

  8. Pingback: How to Bring Web 2.0 to User Assistance (and Vice-Versa) | Peg Mulligan's Blog

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your 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 )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: