Category Archives: confluence tech comm chocolate
Great news! My book is now available in EPUB, Kindle and NOOK formats. The book is called, Confluence, Tech Comm, Chocolate: A wiki as platform extraordinaire for technical communication. It’s about developing technical documentation on a wiki. It has bits about social media, agile environments, search engine optimisation, and more.
The book is available at:
- XML Press – EPUB, Kindle (mobi) and paperback
- Barnes and Noble – NOOK book and paperback
- Amazon.com – Paperback only, for some reason. I’m chasing up on that.
Here are some screenshots of the book on an iPad. Click an image to see the pictures as a slide show.
If you’d like to share your recipe and play with Confluence wiki at the same time, I’d love to see you on the wiki!
Add your chocolate recipes here.
If you’ve baked the cake from the recipe in the book, I’d love to see a photo of it! You can add a photo on the wiki too.
Would you like to help write a guide to using Twitter, especially for technical writers? At the same time, you can try out Confluence wiki and learn from other tech comm Twitter experts.
An interesting fact: The top post on this blog is a technical guide to prepopulating tweets and embedding tweets in a document. (Here’s the post.) It has received more than 13 thousand visits to date. The next most popular post, about writing REST API documentation, has received 11 thousand visits and has been around for two years longer than the Twitter post.
People really want to know about this stuff. We can use Twitter in our documentation, in our careers, and in communication with our peers. How great would it be if we had a technical communicator’s guide to Twitter, written and regularly updated by us!
That idea came to me while I was writing my book, Confluence, Tech Comm, Chocolate: A wiki as platform extraordinaire for technical communication. Then I took the idea a step further and made the writing of the guide a project that Ganache, the hero of the book, was tackling. Ganache wrote part of the guide. The screenshots are in the book. She also wrote some stubs for pages that she thought would be useful in the guide.
Now it’s up to us to complete the guide, and to keep it up to date.
How to contribute to the Twitter guide for technical communicators
Go to the wiki, at https://wikitechcomm.onconfluence.com/display/CHAT/About+this+site, and follow the instructions to get a username. It’s free, and you can choose any username that hasn’t yet been taken. You will need to give an email address, but the email address won’t be shown to other users (unless you make your username the same as your email address).
Read the Twitter guide, and fill in the missing details. All contributions welcome. You can edit the existing pages or add new ones. Other people will probably edit your pages too. It’s a wiki, and all logged-in users have permission to update the pages. Content is licensed under a Creative Commons copyright, as specified in the footer of each page.
Who else is on the wiki?
Your name will appear along with the others who are already there. I’m there, and so is Ganache.
I’ve just spent a couple of days on the island of Oahu, in Hawaii, on my way to and from the STC Summit 2012. I couldn’t resist taking this snap:
A number of people have written reviews of my book, Confluence, Tech Comm, Chocolate: A wiki as platform extraordinaire for technical communication. The reviews are thoughtful, quirky, in-depth, and creative. I love the variety of styles. Here’s a roundup, for those who’d like to know more about the book or simply to see what people are saying about it.
The latest is a review with a difference. It’s by Randall Ward of Appfire Technologies. He has called it a “book review and wine/chocolate pairing guide“. If you’re the slightest bit interested in wine, chocolate, or wikis, you’ve got to read Randall’s post.
All reviews to date:
- Book Review and Wine/Chocolate Pairing Guide: “Confluence, Tech Comm, Chocolate” by Randall Ward at HotOnCollaboration.com, 31 May 2012.
- Tasting a little Confluence, Tech Comm, Chocolate by Scott Nesbitt at Communications from DMN, 2 May 2012.
- Must Read: Confluence, Tech Comm, Chocolate by Anne Gentle at Just Write Click, 26 April 2012.
- Book review: Confluence, Tech Comm, Chocolate by Ellis Pratt at Cherryleaf, 26 March 2012.
- New Confluence Wiki Industry-Shaker Book – by Sarah Maddox – Get it by Ellen Feaheny at AppFusions, 24 March 2012.
More reviews will probably appear after the date of this post, as people start receiving their copies of the book. To see the latest reviews, drop in on this wiki page: Book reviews and blog posts and webinars and more.
Thanks so much to everyone who has spent the time and energy writing up a review!