grumpy_cat_pdf

There’s been quite a hue and cry this week over Adobe’s decision to shift Creative Suite to a subscription-only business model. Beginning in June, the company’s flagship boxed set of widely used tools like Illustrator and Photoshop will be moved to, and supported in, the cloud.

It’s a bold move, but not a shocking one, as more software vendors see the benefit of pushing their business to the cloud. It’s certainly more cost-effective than shipping CDs and vying for product placement on crowded store shelves, to say nothing of how easy it is to roll out updates or patches.

Interestingly, Adobe’s other big seller, Adobe Technical Communication Suite, isn’t headed to the cloud. Why? The most likely answer is because desktop publishing tools are becoming increasingly obsolete. With its heavy focus on collaborative PDFs, this particular collection of apps doesn’t have much maneuvering room as companies shift away from reliance on PDFs as their primary information delivery system.

Internal document management and online product help manuals are key reasons companies use PDFs. While the former isn’t likely to change anytime soon, the latter is heading the way of the dodo bird because customers simply don’t like PDF support docs.

When it comes to product help, PDFs as an exclusive means of documentation will work against you. You may have the best product or service your corner of the market has ever seen but if all your supports docs are PDFs, you might as well be offering manuals on stone tablets.

Today’s product manuals aren’t really manuals in the traditional sense. They’re collaborative, fluid, current, living databases filled with knowledge. User Manual 2.0, if you will.

Here are five cold, hard truths about PDF product support:

crybabyPDFs make customers cry. Here’s a typical usage scenario: Have a product question, head to the company wesbite’s help section. Hope for a quick answer, get directed to a huge PDF instead. Make a sandwich while it downloads. Try searching the document for your question, get 93 hits on your search term. Sigh audibly.

Make a stiff drink, then bravely poke through each response to find a useful answer. Rejoice when answer #89 seems to be what you need. Cry when you discover the PDF hasn’t been updated in two years and the information is wrong. Launch laptop at the wall.

If you want to be responsible for tears and crushed dreams, make sure all your product help docs are PDFs.

A living knowledge base, on the other hand, lets users quickly find the answers they need. Since it’s easy to update and keep current, customers know they’re getting the right answers every time. Software vendors can take product support a step further with in-product contextual help that allows users to access information related to what they see onscreen — without ever leaving your app.

 

burning_moneyPDFs cost your company money. Static documents are expensive to maintain. Somebody (or several somebodys) need to constantly monitor them for accuracy, make changes as needed, convert and upload documents, and so on. The hours your team spends managing PDFs are far better spent helping customers directly instead of tinkering with static manuals.

A living knowledge base helps maintain itself by continually updating across all channels. It’s a collaborative system that gives customers and support agents the real-time information they need, when they need it. On top of that, you’re not paying team members to constantly update PDFs or losing money when frustrated users jump ship for a company with better customer support.

 

gogglesPDFs look unprofessional. Back when the world was on dial-up, websites were single-page affairs, and hosting space was a million dollars a GB, there weren’t many options for getting product help into the hands of users. Today, there’s simply no reason for companies to overlook technology that makes life easier for customers.

Do you really want to force customers to print out reams of pages at their own expense just to figure out how to use your product? Does it warm your heart to picture the PDFs you worked so hard to assemble shoved in a file in the bowels of someone’s hard drive and forgotten?

PDF product help docs make your company look dated and unprofessional. They send the message that you don’t value your customers’ time or resources. A slick online database filled with loads of documentation that’s easily searchable looks far more professional than an outdated website with huge files to download.

 


dunce_capPDFs don’t help users become experts.
The entire point of customer support is to help users help themselves, to offer them a buffet of options that assist them in finding answers quickly and efficiently. Done right, a good help strategy turns your users into product experts by giving them multiple access points to useful product documentation.

PDF-based support systems have a number of potential fail points and customers have frustratingly few options if the documents are wrong. Sure, they can call a toll-free number or open a trouble ticket, but those avenues make users more dependent on your support team, not less.

Knowledge-based help systems give users multiple channels for finding help and troubleshooting issues. Customers expect to have content that adapts to who they are and the channel they’re accessing. You can’t do that with a static PDF.

 

great_wallPDFs build walls around your teams. Data silos can’t exist within a living knowledge base that’s continually updated and accessed by everyone in the company. PDFs, on the other hand, are locked data points controlled by tech writers.

To be sure, tech writers are an extremely valuable component of product support, but they shouldn’t be the only source of branded product knowledge. Marketing, Sales, Support, Community Managers, and even ancillary support teams have value to add to your existing content, but they can’t do that if all your help docs are protected PDFs.

Collaborative knowledge bases tear walls instead of reinforcing them. If your own teams can’t use your product help effectively, think how your customers must feel.

Used sparingly, PDFs do have their place on a company website. They’re fine for media kits, press releases, printable maps, or for delivering information that rarely or never changes. They’re a terrible method for managing product support info, however. A real-time knowledge base is the help platform your customers need. It’s the new user manual.

Images: Storyvillegirl, Purpleslog, Elvissa, CogdogblogKeith Roper

 

sugarlogo

Sugar CRM, the well known customer relationship management (CRM) platform which is “designed to help your business communicate with prospects, share sales information, close deals and keep customers happy” now uses MindTouch to power their comprehensive support center.

 

Sugar CRM brands itself as the “CRM Made Simple” and their new support site subscribes to this value.

Sugar has done an excellent job organizing support features into easy to navigate categories right on the home page.

image

Customers looking for forums, how-to steps, embedded media tutorials or documentation can quickly and easily navigate to the correct page and find more specific information within Sugar’s effectively organized hierarchies.  Now that’s simple.

Check out Sugar CRM’s new support center for yourself at: http://support.sugarcrm.com/

Amanda Cross

Unless you work for a technical communications boutique that specializes in providing technical information solutions to other companies, there’s a decent chance that your boss’s boss doesn’t really understand what you do.

Being helpful makes people want to include youI think that tech writers in most companies are kind of like the IT guy at the dentist’s office: the rest of the folks are smart and capable, but their expertise doesn’t even overlap. The dentists and dental hygienists think IT is probably necessary, but they’re content to just trust the IT guy to take care of it so long as nothing goes wrong.

Some technical writers like it this way. When people are willing to just let you take care of things, they just take your word for what needs to be done and don’t bug you. Plus, there’s the more nefarious notion that keeping your job and job skills a secret gives you job security because no one else will know how to do what you do.

But that only works for as long as people think that what you produce is necessary, which isn’t going to be as long if they don’t understand your contribution. Besides, when people don’t understand what you do, they can’t imagine new and creative ways to utilize your skills. If you can’t capture your boss’s boss’s imagination with all the cool things you have to offer the organization, then opportunities for exciting new projects can be few and far between.

I say it’s better for your career and esteem not to hoard your tech comm knowledge. Instead, you should share your knowledge freely so that people can have a deeper appreciation for why what you do is so difficult and special and ultimately beneficial to everyone. Here are some methods I use to try to make people around me understand the product documentation effort:

#1 – Internal marketing

Well this one’s obvious: if you want people to know what you do, tell them. We are, after all, professional communicators. This ought to be right up our alley.

Speaking for myself, I try to use lots of interesting channels to make people aware of what’s going on in the Doc team. Read more…

Barb Mosher

A recent salary survey by Dice.com says that senior tech salaries are on the rise. There are a few things we can learn from this change in direction, and it’s not only that good tech people deserve more money.

Harnessing Data…

The Dice Salary survey was conducted online with 8,325 employed technology professionals between September 19 and November 21, 2011. The results showed an average 2% increase in annual wages over 2010 (from $79,384 to $81,327). Bonuses looked even better jumping up 8%.

The salary stats speak volumes about the importance of harnessing data properly for businesses and finding intelligent ways to both understand and use it.

It is our technical people that both create and support the systems that capture big data, and use the tools that analyze it. And it’s big data that many are saying is the key to developing truly great customer experiences. Darren Guaranccia agrees with this saying:“ Today’s analytics compress their collected data into summary statistics to save space. Big data is the promise of retaining this beautifully detailed data, and helping us plumb its depths to better engage and interact with our customers, even in real-time.” Read more…

Vannevar Bush portrait

frustrated baby via Flickr by Niklas HellerstedtI recently had an abject lesson in how end user success is strongly correlated to a company’s success when I won a telescope from a holiday drawing. I’m not a telescope kind of person per se. I’ve never used a telescope and the extent of my constellation knowledge is Orion’s Belt and maybe the Big Dipper – or is it the Little Dipper? But after I got home from the party I was so excited to open the box and get it up and running.

Unfortunately, the telescope company didn’t particularly care whether I used the telescope or not. I say this because as soon as I opened the box, I saw a telescope in little pieces that needed assembly. Usually assembling things doesn’t freak me out, but when I took a look at what they called ‘instructions’ I was far from excited.

More doesn’t mean ‘better’

Included in the box was not one, but two instructional guides and a DVD. Let’s just say more is not always better. The documentation was like a puzzle where I had to hop from one PDF manual to another and then jump on my computer to download a CD which was full of more PDFs that were supposed to supplement the first two manuals. It was not fun, not pretty and by the time I had halfway assembled the telescope I just gave up. I put the pieces back in the box and went online to return it.

It’s called hypermedia and it’s been around 80 years now

This isn’t just about me getting frustrated when I was putting together a telescope, there is a much more important lesson here. We are now in the age of computers. And guess what–these complex machines allow me to connect to the Internet and interact with hypermedia (that’s what we now call interactive web pages), which Vannevar Bush designed way back in 1930 (see Memex) as a way to foster and accelerate learning and information transfer. Today we’ve taken the hypermedia concept even further by baking “social” into the fabric of the web. With this in mind, why would any company today feel it is appropriate to give it’s user a PDF- literally pictures of paper- and pretend it’s sufficient. Read more…

One of our own, Corey Ganser, presented “Who Cares about Your Content?” at LavaCon this year. An interview with Corey was recently published on TechWhirl. In it, he stresses the steps content strategists and technical communicators must take in order to prove their worth and get the recognition they deserve.  Here’s an excerpt from Corey’s TechWhirl interview: “Building the Business Case for Technical Communicators by Leveraging Talent, Skills and Passion”

Use Analytic Data of Content to Prove your Worth

Demonstrating value is crucial in the field of technical documentation. Corey suggests Tech communicators push project managers to include a content plan alongside their technology plan, financial plan, and product development plan… Backed by the data, “technical communicators can sit at the big table with the managers,” Corey says, and prove themselves as valuable resources for the company. As a result, a technical communicator can quantify the value of wearing multiple hats, and demonstrate how that their time, money, and energy are effectively being spent to benefit the company’s bottom line.

Corey continued by recommending that technical communicators prove their value to the company in various aspects. “People need to re-define their contribution to a company as a technical communicator. For example [technical communicators] often get caught up with buzzwords and instead need to think strategically as a content strategist about how users can interact with the company who produces the product.”

Documentation Should Help, Not Function as an Afterthought

In our interview, Corey focused on how documentation is often perceived as an afterthought. Read more…

It’s time for a little quiz. I’m going to run 5 terms by you quickly, you have to tell me what they mean. Ready?

  1. “customer experience”
  2. “social business”
  3. “content is king”
  4. “customer is king”
  5. “the squeaky wheel gets the grease”

How did you do? Not so great I bet. If you are a business trying to sell your product or service, you probably don’t really care about all these terms marketers are throwing around. You just want to know how to give your customers and prospects the information they need to make the decision to buy from you and/or be happy in the decision they did make to buy from you.

We seem to finally be settling into a world where the customer has most of the power. What this means is that you can have all the fancy websites and marketing brochures you want, but if you aren’t thinking about what your customers need to make decisions, then you’re wasting a tidy sum. And these decisions, by the way, should be in your favor — that’s kind of important.

More Information Than You Know

The online world has become a place where people can quickly find information. But it’s not the only place they look. So you need to be sure you are consistent in your approach to providing that information. Content is the tie that binds all your marketing and support channels together. But it’s about more than great content. You have to offer that content in the right context.

Read more…

Our latest webinar, “Managing Content Projects: What You Need To Know To Succeed” was a discussion between Scott Abel, The Content Wrangler and content strategist Joe Gollner. The two discussed some of the most important steps involved in managing a content project. Real project experiences were shared to set the stage for a discussion of what people should keep in mind when they are called upon to whiteboard a project plan or to review a project that is currently underway.

The webinar was an action-packed 60 minutes! The recording and Q&A are now available below. Enjoy!
Read more…

This week for the MindTouch TCS feature review, we are going to look at how we leverage conditional statements within documentation to show different information to different users.

Before we jump into how this works, let’s take a look at the technology behind it. MindTouch has a built in programming language called DekiScript that allows you to add business logic within a MindTouch TCS page. This means that you can add conditional statements to your documentation to only show certain content in certain situations.
Read more…

Our latest webinar, “How Interactive Documentation Builds Corporate Value (and Esteem from your Colleagues)” was a discussion between Scott Abel, The Content Wrangler and Amanda Cross, Documentation Manager at Exact Target. Scott and Amanda discussed the common myths about the dangers of making documentation social and how joining the online conversation provides you with opportunities for market innovation, building your brand, improving customer experience, and driving revenue. The two also talked about strategies that can be employed to convince others in your organization that using social tools are essential for building customer engagement.

The webinar was an action-packed 60 minutes! The recording and Q&A are now available below.
Read more…