a little bird told me... about a good page in your user guide
DESCRIPTION
Presentation for the Sydney Technical Communicator's Group, 4 May 2001. Subject: Using Twitter in and around your documentation.TRANSCRIPT
![Page 1: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/1.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
A little bird told me…about a good page in your user guide
Sydney CBD Technical Communicators4 May 2011
Twitter in and around your documentation
![Page 2: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/2.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
About me@sarahmaddox
Technical writer at Atlassian
http://www.youtube.com/travellingworm
http://www.linkedin.com/in/sarahmaddox
http://www.flickr.com/people/31065906@N08/
http://ffeathers.wordpress.com
http://www.facebook.com/#!/sarahmaddox.fb
![Page 3: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/3.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Introduction to Twitter
Twitter as a medium for release notes
Tweeting hints and tips
Interactivity in your documentation: Dragon Slayer
Twitter and your career
In this presentation
TwitterDocsYou
![Page 4: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/4.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Max 140 characters
People really do tweet about lunch
What is Twitter?
Show me
![Page 5: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/5.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
But that’s gobbledegook!
Conventions add meaning, like @, RT and #
Twitter linguistics and conventions
![Page 6: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/6.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Tweet a message
Include the # tag in your tweet
See the Twitter stream: http://search.twitter.com/search?q=SydneyTechComm
#SydneyTechComm
Let’s tweet – right now
That’s metadata!We know all about that!
![Page 7: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/7.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Why use Twitter in your documentation?
The social enterprise
Engaging customers and readers
Documentation as a living, interactive hub
Our readers are already discussing us on social media
Let’s join the conversation
Hear what they have to say
Show them we care
Use the media for our own good
![Page 8: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/8.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Tweeting your release notes
Ooo-er, did I tweet that?
Bite-sized chunks
Interactive
Shareable
On an iPhone
![Page 9: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/9.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Live Twitter stream embedded into the page
Tips via Twitter #ConfluenceTips
Show me
![Page 10: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/10.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Cool integrated development suite but
Complex installation and configuration
Emerging technologies (gadgets, OpenSocial)
Dragon Slayer docs to the rescue
Lead you through the setup
Demo the cool integration possibilities
Document the steps and the pain
Track the improvements
Turn pain to fun
Dragon Slayer – the problem
![Page 11: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/11.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
9 stages, each with many steps
Rewards:
Charlie’s clothing and armour
Fun and camaraderie with Atlassian and other dragon slayers
Getting the complex task done
Sense of achievement
T-shirt, fun
Dragon Slayer – the game
![Page 12: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/12.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Fun stuff is at top and bottom of page
Good solid, well-tested “how to” instructions in between
Dragon Slayer pages
![Page 13: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/13.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Live Twitter stream on the page
Auto-tweeting link
Dragon Slayer interactivity
![Page 14: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/14.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Adding an auto-tweeting link
http://twitter.com/home?status=My status
![Page 15: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/15.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
People love a game
Dragon Slayer Twitter stream
Show me
![Page 16: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/16.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Conversation
Swapping information
Ideas
Fun
There’s more to Twitter
![Page 17: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/17.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Tech comm chat on Twitter
Tag: #tcchat
Next session:
Thursday 5 May, 11am (Sydney time)Wednesday 4 May, 6pm (US Pacific time)
“Making Docs More Interactive and Interacting With Customers”
Thank you Julie Norris
![Page 18: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/18.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
How to join the #tcchat session
Sign up for a Twitter username (optional)
Log in to Twitter at 11am tomorrow
Do a Twitter search for #tcchat
Read the tweets
Go to your own Twitter home page and tweet Hallo, I’m Sarah in Sydney #tcchator something similar (optional)
Tweet your contribution to the topic (optional)
![Page 19: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/19.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Contacting me
Email: [email protected]
Twitter: @sarahmaddox
http://twitter.com/sarahmaddox
LinkedIn: http://au.linkedin.com/in/sarahmaddox
Blog: http://ffeathers.wordpress.com
Other blog: http://travellingworm.wordpress.com/
![Page 20: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/20.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
References 1 Download this presentation: http://bit.ly/iEzdkV
Twitter: http://twitter.com/
Twitter’s note about the limitations of the search: http://apiwiki.twitter.com/Things-Every-Developer-Should-Know#6Therearepaginationlimits
A site that will URL-encode your text for you: http://www.albionresearch.com/misc/urlencode.php
Twitter as a medium for release notes Blog post, including an introduction to Twitter and many useful
comments from readers: http://ffeathers.wordpress.com/2009/06/08/twitter-as-a-medium-for-release-notes/
![Page 21: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/21.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
References 2
Hints and tips via Twitter
Our “Tips via Twitter” page for the JIRA documentation. http://confluence.atlassian.com/display/JIRA/Tips+via+Twitter
Our “Tips via Twitter” page for the Confluence documentation. http://confluence.atlassian.com/display/DOC/Tips+via+Twitter
Blog post about tips via Twitter: http://ffeathers.wordpress.com/2010/06/22/hints-and-tips-via-twitter/
Rewarding people for tweeting hints and tips: http://ffeathers.wordpress.com/2010/08/14/badges-for-twitter-tips-and-thanks-to-technical-writers/
Tech comm chat Home page http://www.facebook.com/TCchat1#!/TCchat1 Guide http://www.2morodocs.com/2010/09/twitter-chats-101/
![Page 22: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/22.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
References 3
Twitter for interactive documentation
The Dragon Slayer documentation: http://confluence.atlassian.com/display/ATLAS/Here+Be+Dragons
Blog post about the Dragon Slayer documentation: http://ffeathers.wordpress.com/2009/10/10/i-got-dragons-and-tweets-in-my-docs/
Blog post on how to embed Twitter streams and prepopulate tweets:http://ffeathers.wordpress.com/2011/01/02/how-to-embed-twitter-streams-and-prepopulate-tweets-in-your-document/
The end – thanks folks!
![Page 23: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/23.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 24: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/24.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 25: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/25.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 26: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/26.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 27: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/27.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 28: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/28.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 29: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/29.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 30: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/30.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 31: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/31.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot
![Page 32: A little bird told me... about a good page in your user guide](https://reader034.vdocuments.site/reader034/viewer/2022042504/554ca184b4c905c10d8b535f/html5/thumbnails/32.jpg)
Sarah Maddox | Tweet @sarahmaddox | Blog http://ffeathers.wordpress.com | Email [email protected]
Screenshot