Dojo Masters - Collaborative Writing in Distributed Teams
-
Upload
johnhedtke -
Category
Technology
-
view
189 -
download
1
description
Transcript of Dojo Masters - Collaborative Writing in Distributed Teams
![Page 1: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/1.jpg)
Collaborative Writing in Distributed TeamsJohn Hedtke, Double Tall Consulting
Fellow, Society for Technical Communication
4/8/2014TC Dojo Open Session 1
![Page 2: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/2.jpg)
Speaker BackgroundJohn Hedtke has worked in high tech for
over 30 years and has written documentation and books for many leading software products. John owns and operates Double Tall Consulting, a company that provides writing, consulting, and training services to private and government clients in all fields. He also runs a blog for people who want to become authors at http://tradebookauthor.com.
When not otherwise occupied, John plays the banjo, writes magazine articles, and writes slogans for a button company. John is a Fellow of the Society for Technical Communication and serves on the STC’s Nominating Committee.
![Page 3: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/3.jpg)
What this presentation covers
• Why you should collaborate
• Why you shouldn’t collaborate
• How to collaborate successfully
• Tools and resources
• Summary
4/8/2014 TC Dojo Master Session 3
![Page 4: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/4.jpg)
Why you should collaborate
• You need an entry point.
• You don’t have the expertise.
• You’ll learn something watching your teammates.
• You don’t have the time.
• You don’t have the energy.
• The boss says so!
4/8/2014 TC Dojo Master Session 4
![Page 5: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/5.jpg)
Why you shouldn’t collaborate
• If you could do it just as well yourself.
4/8/2014 TC Dojo Master Session 5
![Page 6: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/6.jpg)
Collaborating successfully
For whatever reason, you’re going to collaborate on a project. Here’s how to do it without friction.
4/8/2014TC Dojo Open Session 6
![Page 7: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/7.jpg)
Plan the work
• Build a comprehensive documentation plan!
– Scope and purpose
– Project description and list of deliverables
– Detailed outline
• Use a strong documentation plan format. You can download a doc plan template here:http://www.hedtke.com/downloads/!blank_doc_plan.doc
4/8/2014 TC Dojo Master Session 7
![Page 8: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/8.jpg)
Assign the work
• Attach someone’s name to every task.
– Content sections in the outline
– Reviewing
– Indexing
– Creating online help
– Releasing
– …and so on
• Tasks don’t have to be sequential.
• Make sure every task is covered!4/8/2014 TC Dojo Master Session 8
![Page 9: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/9.jpg)
Do the work
• Get writing!
• Have regular meetings to report progress to each other.
• Keep copies of everything.
4/8/2014 TC Dojo Master Session 9
![Page 10: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/10.jpg)
Avoiding problems
Collaborating can lead to incredible friction even under the best of circumstances. Here are some tips on how to avoid on-the-job mayhem.
4/8/2014TC Dojo Open Session 10
![Page 11: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/11.jpg)
Mind your boundaries
• Boundary violations are the single biggest problem.
• Don’t get frisky!
– If you think you can do something better, discuss it.
– Don’t be a cowboy.
• Don’t be surprised if someone else gets frisky.
– Work it out.
4/8/2014 TC Dojo Master Session 11
![Page 12: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/12.jpg)
Identify a decision-making process
• Figure out who makes final decisions.
• Resolve as many issues up front as possible.
• Give everyone the benefit of the doubt.
• Play nice!
4/8/2014 TC Dojo Master Session 12
![Page 13: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/13.jpg)
Negotiate changes
• Announce changes to one and all.
– Whiteboard
– Group emails
– Wiki
• Be excruciatingly clear.
• Don’t be afraid to swap assignments, but make sure it’s okay with everyone first.
4/8/2014 TC Dojo Master Session 13
![Page 14: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/14.jpg)
Tools and resources
Here are suggestions for a few tools and resources that will help you collaborate.
4/8/2014TC Dojo Open Session 14
![Page 15: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/15.jpg)
Tools for collaborating
• A chat client (even if you’re all together).
– Skype is my fave but there are dozens of others
• Reliable email.
• Safe file-sharing.
– FTP
– Versioning software (such as Perforce)
– Don’t use Google fileshare or DropBox
• Use the same software throughout.
4/8/2014 TC Dojo Master Session 15
![Page 16: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/16.jpg)
Resources for collaborating
• Documentation plan template and info are at http://tradebookauthor.com
• Book: “Managing Virtual Teams”
4/8/2014 TC Dojo Master Session 16
![Page 17: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/17.jpg)
Summary
We’re about done. Here are your takeaways.
4/8/2014TC Dojo Open Session 17
![Page 18: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/18.jpg)
Key points to remember
• Plan what you’re going to do.
• Don’t get frisky.
• Keep in touch with each other.
• Play nice.
4/8/2014 TC Dojo Master Session 18
![Page 20: Dojo Masters - Collaborative Writing in Distributed Teams](https://reader034.fdocuments.us/reader034/viewer/2022042715/559ac56a1a28abea138b4607/html5/thumbnails/20.jpg)
Thank you!
4/8/2014 TC Dojo Master Session 20
John HedtkeDouble Tall Consulting2171 Kingfisher WayEugene, OR USA [email protected]
Feel free to email or write if you have questions.