This Week in Wikis - Week 3

A shorter list this week, but here is a quick summary of interesting wiki related articles etc. that I came across over the last seven days.

- Atlassian Snags 2009 Elearning! "Best Social Learning Tool" Award.
- MyWiki app of the iPhone
- Appropedia - the 'green" wiki
- Antifeatures Wiki Catalogues Tech Annoyances You Hate

as always a full archive of all Wiki Week links can be found online at http://delicious.com/wikiweek

Video Interview on Using Wikis in Technical Documentation

I was recently interviewed by Ellis Pratt of Cherryleaf about the use of wikis in technical documentation. It was a fun and wide ranging conversation that lasted about an hour.

Ellis has prepared the following couple of short, 10 minute, extracts from the video interview and posted them on You Tube.

The Augmented Future of Technical Documentation?

For those of us who have written, or write, technical documentation for hardware, and engineering products, this video of a BMW research project perhaps gives a glimpse of the future.



And BMW are not alone, a quick search online produced videos of several different prototypes of using Augmented Reality for maintenance, service and repair procedures.

This type of development, once again reinforces my message that technical writers need to step up and become technical communicators comfortable with developing content that can be delivered in any media.

Technical documentation is not just about the written word, it is about the communication of ideas and knowledge.

Hello Publishing, Meet the other side of Publishing

Over at the TeleRead blog, which reports on trends in the growing eBook market, editor Roger Sperberg recently posted a piece entitled "Why Do Publishers Need XML?" in which he thoughtfully examined the advantages that traditional book publishers could benefit from by adopting an XML mark-up.

I won't reiterate his arguments here, most of which I agreed with, and suggest that instead you go read the article.

However one statement really caught my attention, Sperberg's suggestion that book editors should learn XML as part of their job. His statement was that

"...that we (book publishers) can’t exploit (eBooks) until editors understand XML as well as English grammar, and regard metadata as valuable as a plug on Oprah."

At face value a very valid point, but as I read through the article and the various comments attached to it, I suddenly realized there seemed to a complete lack of awareness that those skills already exist within a profession that understands a bit about publishing.

Here's a little extract from my own comments.

"As for asking editors to learn XML, sure they need to be aware of it and its power – but there is a whole profession of people out there who already know about applying XML mark-up to content – the Technical Publications industry. Oh and a lot of them know about XSLT and XSL-FO too, and are skilled in the tools that use these standards.

And believe you me, for people who have spent years tagging things like aircraft manuals and software user guides, tagging a trade mass market book is not too great of a challenge."

It is often said that traditional book publishing is dying, and a large part of that is because traditional publishers still see the physical book as the product, and not the content. But today content is king, and we need to make that content available across all platforms, and that means mark-up.

Does the salvation of the book publishing industry reside in the world of technical and business publishing? - It just might...

A short commercial...

Join me at 1:00pm ET on Wednesday (Jan 20th) when I present a live webinar on 'What Technical Communications Can Learn From The Comics."

Register HERE.

This Week in Wikis - Week 2

Another round up of interesting links and articles about wikis found while I continue to work on my upcoming book "WIKI: Grow Your Own for Fun and Profit."

Week 2

• Writing in the Open: Using Wikis to Create Documentation
• Wiki Cheat Sheets
• Wikis? A meme? It’s more likely than you think.
• A Wiki Isn't A Character From Star Wars
• Motor Sports organization uses wiki to write a new rule book.
• An Indian view of Wikipedia and wikis in general .
• W3C - Semantic Web Standards wiki
• The Independent Publishing Wiki
• Collaboration requires a culture of comfort
• ToyPedia - wiki for Toy Collectors
• Mashup of Wikipedia and Google Maps - don't just read about an event - see where it happened.
• Fact or Fiction: Should You Use Wikipedia for Research ...

And a reminder that all the wiki links can always be found at http://delicious.com/wikiweek.

English as She is Spoken - it can be difficult at times.

Earlier today, The Content Wrangler, Scott Abel, posted the following on his FaceBook page:

[English Lesson du jour] Leonard Lunsford says the letter combination "ough" can be pronounced 9 different ways. The following sentence contains them all: "A rough-coated, dough-faced, thoughtful ploughman strode through the streets of Scarborough; after falling into a slough, he coughed and hiccoughed."

This sort of thing is a perfect example of why we shouldn't assume everyone in your intended audience understands the subtleties and nuances of the English language - particularly important if you are creating technical or business content for an audience who are not native English speakers.

As I mentioned to Scott - I will definitely be using this as an example in the Simplified Technical English training courses I run from now on.

This Week in Wikis - Week 1

Welcome to a new feature on THE CONTENT POOL, "This Week in Wikis." - As I continue to work on my upcoming book "WIKI: Grow Your Own For Fun and Profit" I am reading and bookmarking numerous articles and online mentions of wikis, wiki tools and examples of wiki usage.

So I thought it might be useful each week to share a selection of wiki related articles I came across over the previous seven days.

Here's this week's selection:
- Wired's "How-To" Wiki
- CarbonCopyPRO Introduces New "Wiki" Marketing Platform,
- MobileRead Wiki on eBook technology
- Wiki on research for librarians
- Improved wiki usage in 2010
- How Non-Profits Are Using Wikis
- Wikipedia:Manual of Style

All the "This Week In Wikis" links will be archived, and available, at http://delicious.com/wikiweek

Comics in Corporate Communications

Is there a place for comics in corporate communications? I certainly think so, and have long been a vocal proponent of using comics graphic and story telling techniques in the business world.

Recently Scott Abel, industry leading consultant and blogger, offered me the opportunity to write about the subject on his CONTENT WRANGLER blog.

My two page article Comics Can Make You A Better Communicator is now up, and you can check it out simply by clicking HERE.

The GHOST MAP and THE SOCIAL WEB

Over the last few weeks I've been reading a fascinating book entitled THE GHOST MAP by Steven Johnson, that details the story behind the 1854 cholera outbreak in London and the efforts of a few men, including the physician Dr. John Snow, to isolate the cause.

Dr. Snow is perhaps most celebrated for developing the titular "Ghost Map" that (and this is simplifying the process) helped form a visual correlation between the number of deaths and the proximity of the contaminated water pump that turned out to be the root cause.

It's a fascinating book for anyone interested in social sciences, history, biology, and communication. A large part of the story discusses how Snow culled information from a variety of apparently disparate sources, some written, some verbal, and his own observations and bought them together to develop one of the most celebrated examples of technical communication and visual design of the modern age.

But the book itself has one great failing - it doesn't include a copy of the map! You know the map that is referenced in the title of the book? The map that has a whole chapter to it and to which the author constantly refers. A map that is in the public domain and widely available on the net. Yes THIS map.

Click HERE for a larger high resolution version of the map.

Here is a great example of setting up a reader / user expectation and failing to meet it. The quality of the content in this book was excellent, yet the one thing I will remember most (and obviously decided to blog about) was that single point of failure.

So how does this relate to corporate communications - simply put - make sure that you deliver the content you promise - even if it's an implied promise. And titles are the first place you set up expectations of what's to follow. Make sure you deliver.

So to make sure I deliver on my promise, what does the Ghost Map have to do with the Social Web? In the later two chapters Johnson goes on to discuss the impact of Snow's work on science in general and the use of cartography in mapping social trends.

In that discussion on maps he makes the following observation:

"The amateurs are producing the most interesting work, precisely because they have the most textured, granular experience of their community."

An astute observation and not one that just applies to cartography projects, - it also applies to the changing face of corporate communications and social media. The day of the 'experts' being the sole trusted source of information. As Don Tappscott & Anthony Williams put it in their book Wikinomics:

"There are always more smart people outside your enterprise boundaries than there are inside."

In London in 1854 the experts inside the organization, i.e. the Government, were convinced it was the mythical 'miasma' that was killing people. It took informed 'amateurs' to identify the root cause and develop the documentation to prove their case.

Any organization today should be listening to, and encouraging, the participation of the smart people outside.

Imagine if Dr. John Snow had access to a wiki, or Twitter?