How to build a multi-million dollar business by putting manuals on the Web

One of the issues we’ve been promoting for many years is the importance for Technical Authors to publish their user guides and online Help on the Web. A surprisingly large amount of companies still don’t offer Web versions, for reasons that include:

  • It’s too difficult
  • Our competitors might read it and reverse-engineer our product
  • Support/Training/Marketing will object

The problem with this approach is that others are likely step in and fulfil this need. One such person is Kyle Wiens, CEO of ifixit.com, who I saw present at the STC Summit 2012 conference last week.

Kyle has built a multi-million dollar business on the back of offering repair manuals that manufacturers choose not to put on the Web. The manuals are available free-of-charge, with ifixit.com making money from selling spare parts.

self-repair manfiesto

Wiens said that if machines in other industries — for example, tractors used by farmers — were to break down over a handful of years and couldn’t be easily repaired, consumers would openly revolt. “In industries where consumers really care about a quality, long-lasting product, there’s no way companies can get away with it,” he said. more

We’ve suggested in the past that organisations publish Help for their competitors’ products, so they can engage with their future customers.

Publishing to the Web provides a path to publishing to mobile devices and tablets. It also means, finally, Technical Author can measure the value of what they produce – how many people want to read it and what they think of it.

Regardless of the objections from other departments, this is probably the single most important thing a Technical Author can do.

Do you agree?

Our cookie policy

At the bottom of every page on our Web site or in the side bar of this blog, you’ll now find a link to our cookie policy:

We use cookies on this Web site for identifying people who have purchased any of our online training courses via our online shop. If you purchase one of our online courses, we’ll use cookies as one of the ways of giving you access to this course. We also use Google Analytics and Woopra (an analytics service) to record general information on the number of visitors to the site and how they’ve been referred to us. If you continue, you consent to this – but if you don’t want to be tracked, let us know and we can set up an exclusion rule for your IP address in Woopra.

There and back again – Notes from the STC Summit 2012 conference

I have just got back from speaking and attending the Society for Technical Communication’s annual conference in Chicago – STC Summit 12. While my body is back in London, my brain is still partly still halfway across the Atlantic, which might explain any incoherence in this post.

Themes

As there can be ten sessions running in parallel, each attendees’ experience can be unique. However, it is possible to spot the major themes of the conference. These were:

  • content delivered on mobile devices,
  • using HTML 5,
  • intelligent/adaptive content (the content that’s delivered to users differs depending on the context and the user), and
  • using video.

Another theme was: what ever technology changes are likely to appear on the horizon, Technical Communicators are in a good position to handle them. Certainly compared to the Publishing industry.

Highlights

The “Beyond the bleeding edge” themed presentations were very impressive. Mozilla’s Popcorn project could have a big impact on Technical Authors. The popularity of the ifixit.com Web site, and the rapid growth of the company, shows how popular instruction manuals can be if they are accessible on the Web. It also shows what can happen if you don’t publish your content on the Web – someone may reverse engineer the content and publish it on their site.

I also really enjoyed Karen McGrane’s presentation on the approaches the Publishing and News industries are taking to tackle the issue of mobile content.

Thanks to social media, you have a friend in every city

Primarily thanks to Twitter, there were many people I felt I knew already. I was looking forward to finally meeting people such as Rahel Baillie, Val Swisher, Rhyne Armstrong, Janet Swisher, Andrea Wenger, Anker Jain, Joe Gollner, Larry Kunz, Alan Houser and John Hedtke. I didn’t get a chance to say hello to everyone – I missed Scott Abel and Rachel Houghton, for example. Even though Americans are welcoming by their nature, it does help to be connected to people via Twitter.

Differences between European conferences

It’s the first time I’ve spoken at a conference in the USA, and it was interesting to see the differences and similarities between it and the European conferences I speak at.

The STC Summit is bigger than any other similar conference, apart from tekom (in Germany). At the same time, I was speaking, delegates could attend nine other presentations. Some of the presentations, particularly the “beyond the bleeding edge” presentations were more “advanced” than I’ve seen at any European conference.

The conference also has “lightning talks” – three nine x 20 5 minute presentations one after the other. These forced the speakers to be succinct and this format worked very well. There were also a lot of talks on personal promotion – finding jobs, networking, selling yourself etc.

This year’s ISTC (STC equivalent in the UK) conference, “Technical Communication UK”, has a little on mobile content and nothing on HTML 5 or intelligent content. The UAEurope conference seems to be much closer to the STC themes – perhaps because so many of the speakers are from the USA.

Another difference was the number of students and people under 30 attending the conference. The STC places a lot of emphasis on research, professional development and awards, which was good to see.

The elephants in the room

There was a consensus that DITA and other forms of XML were the way to go, but no-one really challenged this belief. Often, content has a short “shelf-life” and consequently little value, so a cheap, quick and dirty solution may be the best solution. DITA is still really weak in terms of the outputs it delivers.

America most definitely has an obesity problem – having another meal an hour after the first, huge portions and cheese sprinkled on everything. So does Britain, but on a different scale. It’s worrying to see the direction in which Britain may go.

There was also a belief that we’ll live in a world of a myriad of mobile devices  - that the 80:20 rule won’t apply. I wonder if just a few devices will end up dominating the marketplace.

There still seems to be an awful lot of people who are not publishing their content to the Web, and if you’re not on Google, you’re invisible. The rise of mobile devices may well be the catalyst for this to change.

Final thoughts

I look forward to watching the recordings of the presentations I missed – the STC’s Summit@aClick site will contain the recordings in 6-8 weeks time. I’m pleased I took up this offer to speak at this event. I found the event was informal, informative and full of humour.

Content doesn’t matter? Don’t tell Coca Cola!

If you’re not sure the value of content and writing, take a look at this video from Coca Cola. Jonathan Mildenhall, Vice-President, Global Advertising Strategy and Creative Excellence at The Coca-Cola Company describes the challenge of content creation to Coca Cola and why it is so important to them.

The terminology Jonathan uses in the video is different to the words of the Technical Author, but the concepts are remarkably similar:

  • He talks about “liquid content” where a Technical Author might say “single sourcing” or ” content-re-use”.
  • “Collaborative, adaptive, content” is similar to “multi-channel publishing”.
  • “Co-creation” is what we might call “user generated content” or “collaborative authoring”.

Coca Cola sees content as conversational – something we’ve talked about being a trend emerging in some forms of online Help.

Pepsi is doing similar things as well

In a competitive market such as fizzy drinks, where price and products are almost identical, content – in its many forms – becomes critically important.

How software users become champions

Matthew Syed is a British sports journalist and former three times Commonwealth Games gold medallist, who has been investigating what is needed to make people excellent at doing any task involving complexity.

He argues that natural talent, your genes, are far less important than many people think. What’s important is practising what you can’t quite do. He argues we grow if we test our limitations, because our body adapts.

So what on earth does that have to do with developing software and Technical Authors? Syed argues there are two opposing views regarding success:

  1. One “school” believes talent is what makes success. This means that if you fail, you believe it’s because you don’t have enough talent. Therefore, you’re likely to give up.
  2. The other “school” believes success is all about practice – the quantity of practice, the quality of teaching and the willingness to test our limitations. This means that if you fail, you believe you can succeed with more perseverance and effort. It’s an opportunity to adapt and grow.

I would argue the whole philosophy of User Assistance is based around the belief that talent is all about practice. It’s easy to forget that others may think it’s all about talent – your developers may believe some users fail because they are stupid, and some of your users may believe they’re just not good enough to succeed. It’s worth checking what they believe.

Another implication is that we should provide assistance and guidance to users as they are doing the task. We should try to avoid interrupting their flow. This suggests providing Help and advice within the application screens themselves.

Thirdly, we should praise people for their effort rather than for their talent.

Bounce

BBC Radio 4 Four Thought

What do you think?

Upcoming Cherryleaf presentations and events

Here is a list of the upcoming Cherryleaf presentations and events:

What is the future for Technical Communicators when many organisations believe products are getting easier and they don’t need to spend so much on user documentation? We’ll look at whether the traditional model for technical communication is broken, research into how “cool” apps such as Facebook do (or don’t) provide Help, and how to deal with developers who believe the need for a user guide is a sign of poor software usability.

With more and more people using the iPad and other tablets for reading technical documentation, this workshop looks at how tablets can be used by organisations to design and deliver technical documents and other forms of User Assistance.

One of the most popular developments in computing in recent years has been the emergence of cloud-based computing and Software as a Service (SaaS). So is technical writing likely to move to the Cloud? In this presentation, we look at how we implemented a cloud-based authoring solution as a way of getting developers to participate in the authoring process.

In this 40 minute (approx) webinar, we’ll provide an overview of some of the emerging information design trends for presenting technical documentation on tablets.

We’ll be hosting our third “Trends in Technical Documentation” talk later in the year. If you’d like to present at this session, then do let us know.

Announcing our ‘Using the iPad as a documentation device’ workshop: 31 May 2012

We’ve completed the slides and booked the training room for our new workshop, Using the iPad (and other tablets) as a documentation device:

With more and more people using the iPad and other tablets for reading technical documentation, this workshop looks at how tablets can be used by organisations to design and deliver technical documents and other forms of User Assistance.

The course will be held in Central London on Thursday 31 May 2012, 9.30am-12.30pm.

You do not need to have a tablet to attend this course, or have previous knowledge of using a tablet.

This course is aimed at Technical Authors and others developing technical documentation and other forms of Help for users.

Places cost £175 ex VAT. For more information, and to book, see Using the iPad (and other tablets) as a documentation device.