Software // Social
Commentary
11/21/2013
08:06 AM
Dennis Pearce
Dennis Pearce
Commentary
Connect Directly
RSS
E-Mail
50%
50%

Social Business Discussions Are The New Documentation

Social business is changing how we document business processes and IT operations. Here's why.

When I was much younger and bought a new radio, TV, or VCR, the first thing I did was read the manual cover-to-cover so I could understand how the thing worked. This was easy to do because most tools and electronic devices had a single function, which usually equated to a relatively short and simple manual.

But today, when you buy devices like these, you also get remotes with about 30 or 40 buttons on them that all require manuals. My car comes with multiple thick manuals, too, including one just for the navigation system. And most software documentation is deceiving: You never really see the pages piled up on top of each other; you just get lost in a labyrinth of links as you jump across topics that are supposedly related.

As products become more feature-rich, their documentation becomes longer and more complex. As a result, it has the perverse effect of conditioning users to skip reading it altogether. When I get a shiny new car, smartphone, or TV, the last thing I want to do is spend a week reading the documentation before I use it. Instead, I just dive right in using the basic features and learn over time about the bells and whistles by trial and error, dipping into the documentation for a specific reference, searching for an answer on the web, or just asking somebody.

[ Do you have a long-term perspective? Read Picturing Your Social Business In 2020. ]

Inside an organization, the problem is often the opposite -- there's too little documentation, not too much. Think about your process for ordering office supplies or having your laptop updated: Most internal tools and business processes are poorly documented, if at all. Some are legacy systems whose creators are long gone. Some are ad hoc systems that were thrown together on the fly but worked so well that they've gradually become business critical. How many of you use "Bob's spreadsheet" or "Mary's monthly report"? (It's a dead giveaway when the tool has a personal name associated with it.) And none of them have information developers assigned to fully document their capabilities.

But how does this all relate to social business? In the past year, I've noticed how helpful our social software vendor's customer community site has been in answering questions. I'm not talking about how others respond to questions I might post -- although that's also been a very useful feature -- but rather the large collection of content that has built up over time.

Documentation isn't what it used to be, thank goodness. (Source: Flickr user acaben)
Documentation isn't what it used to be, thank goodness.
(Source: Flickr user acaben)

When I have a question about their software, I bypass their documentation (sorry, tech writers!). The first thing I do is go to the community and type in some search terms. More often than not I find the answer to my question, and it's in a discussion rather than in a more formal document. Some of these discussions have spanned months and sometimes years, giving me context and nuance to the answer that I just couldn't get otherwise. For example:

"I have question X."

"Here's the answer."

"Well, that's true in most cases but if you have this configuration then you need to do Y." (Oh hey, that's my situation!)

When employees work out loud in a transparent social platform, they are documenting their tools and processes on the fly as they build them. Documentation is no longer the extra work that no one wants to do; it's a natural, inherent part of the process. As an added bonus, you often get an explanation of why something works the way it does, not just how.

There will always be a place for formal documentation, especially with commercially available products. But the complexity of those products and our behavior as consumers are pushing us toward a model that favors discussions over documents. And especially inside the firewall, as social business progresses and more employees begin working out loud, organizations may find that with a good search engine and a little bit of tagging they can document many of their tools and processes for free. What do you think?

There's no single migration path to the next generation of enterprise communications and collaboration systems and services, and Enterprise Connect delivers what you need to evaluate all the options. Register today and learn about the full range of platforms, services and applications that comprise modern communications and collaboration systems. Register with code MPIWK and save $200 on the entire event and Tuesday-Thursday conference passes or for a Free Expo pass. It happens in Orlando, Fla., March 17-19.

Comment  | 
Print  | 
More Insights
Comments
Threaded  |  Newest First  |  Oldest First
Kristin Burnham
IW Pick
100%
0%
Kristin Burnham,
User Rank: Author
11/21/2013 | 8:48:20 AM
Intranets & internal social networks are key
I hate reading instruction manuals. Whenever I have a question about why something stopped working or when I see an error message, I always Google it. And inevitably what pops up first: Similar questions -- and solutions -- on user forums.

The applications of something similar in the workplace are just as useful: Have a question? Skip the email in which you CC everyone and search for the answer on your intranet. If your company has an internal social network, use that to ask the question or search for the answer. You'll likely find it quickly, and without cluttering everyone's inboxes.
David F. Carr
50%
50%
David F. Carr,
User Rank: Author
11/21/2013 | 9:31:19 AM
Re: Intranets & internal social networks are key
Kristin, I couldn't agree more. I've always found it hard to really absorb technical instructions in the abstract, whether it's how to use a device or how to work with a programming language. Once I've painted myself into a corner and really need the information, that's when I go look it up. Community resources are great for that kind of just in time information. Of course, to be a good community member, you ought to give back some discoveries of your own from time to time.

That's what it's all about!.
David F. Carr
50%
50%
David F. Carr,
User Rank: Author
11/21/2013 | 11:50:17 AM
For technical writers, too
This trend is absolutely relevant to the technical writers who do documentation, who have also had to adapt their work. See this column from a couple ofhears ago.

How Social Media Changes Technical Communication - InformationWeek http://www.informationweek.com/social-business/wikis/how-social-media-changes-technical-commu/232301245 via @InformationWeek
SachinEE
50%
50%
SachinEE,
User Rank: Ninja
11/27/2013 | 1:52:58 AM
Re : Social Business Discussions Are The New Documentation
There is another side to why we are getting weary of reading documentations and instruction manuals. It is because we are aware of the basic functionalities of most of the devices we buy today. There may be some new features that we can look up later in the manual but that certainly doesn't hinder our using it at first. While in the past we had to use some kind of device for the first time so we had to read the instruction manual first.
SachinEE
50%
50%
SachinEE,
User Rank: Ninja
11/27/2013 | 1:53:02 AM
Re : Social Business Discussions Are The New Documentation
@ David F. Carr, well that's the ethical part of it. If we are taking something from somewhere, we should give some as well from time to time. We have to keep in mind that in such communities, people solve our problems sparing time out of their busy schedules. We should also spare sometime every now and then to share whatever little we know.
Social is a Business Imperative
Social is a Business Imperative
The use of social media for a host of business purposes is rising. Indeed, social is quickly moving from cutting edge to business basic. Organizations that have so far ignored social - either because they thought it was a passing fad or just didnít have the resources to properly evaluate potential use cases and products - must start giving it serious consideration.
Register for InformationWeek Newsletters
White Papers
Current Issue
InformationWeek Tech Digest - July 22, 2014
Sophisticated attacks demand real-time risk management and continuous monitoring. Here's how federal agencies are meeting that challenge.
Flash Poll
Video
Slideshows
Twitter Feed
InformationWeek Radio
Archived InformationWeek Radio
A UBM Tech Radio episode on the changing economics of Flash storage used in data tiering -- sponsored by Dell.
Live Streaming Video
Everything You've Been Told About Mobility Is Wrong
Attend this video symposium with Sean Wisdom, Global Director of Mobility Solutions, and learn about how you can harness powerful new products to mobilize your business potential.