Your SlideShare is downloading. ×

Content strategy in Technical Communications


Published on

Slides from my presentation to tcworld India 2012. Describes how Scriptorium sees content strategy and how to go about implementing a techcomm content strategy in your workplace.

Slides from my presentation to tcworld India 2012. Describes how Scriptorium sees content strategy and how to go about implementing a techcomm content strategy in your workplace.

Published in: Technology, Business
  • Be the first to comment

No Downloads
Total Views
On Slideshare
From Embeds
Number of Embeds
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

No notes for slide
  • Canonical def'n from Kristina Halvorson
  • We look at it from POV of four actors or 4 D's Content strategy is process of dealing with these four things as they relate to your content.
  • Encompasses a lot Localization, Storage Creation of graphics Decision to use graphics rather than text.
  • What format should I use? PDF, HTML, both, neither Process of creating deliverables from content. In “olden” days the delivery tool was the same as the development tool. These days, the development tool isn't necessarily the same tool you use to create deliverables.
  • Once you create the deliverable, you have to convey it to your customer. Web, Print, help,
  • Information that is time-sensitive. eg Tax Software Price guides Another issue: How to deal with back-rev versions of SW?
  • Clarify diff between TechComm content strategy and Web content strategy. Purpose of WCS is to persuade (such as “buy my product”) Tim O'Reilly: TechComm is enabling people to do stuff with your products. Marcom is about persuading that your thing is awesome or cheap or useful Some overlap. Convince to buy by showing doc. Persuasion. “Web Content Strategy” is marketing. Reading an article, be aware.
  • Tech Comm Content strategy What is the promised land of TechComm Cont-Strat? Without taking 40 years. What will it look like? Answer is: it depends. Rest of talk: Give a road map for dealing with Content Strategy.
  • Step 1 is NOT tools. Determine Business goals of Tech Comm Positioning: we're really cool, eg Game docs, need fun. eg Financial sw, need to have quality appearance Call deflection. Keep the cost of TechSupport down. Goal of TechComm content might be marketing. Let's take a look at some examples of business goals expressed by TechComm..
  • Examples of how Tech Comm priorities manifest themselves in doc. Warning is primarily defensive. Says something about the company that they'll dedicate 20% of the page to legal.
  • “Green” Thought went into scheme, says they care about branding.
  • What does this say? “our stuff is ugly and we don't care.” Warnings. Similar PDFs with TOC and no links.
  • Online PDF, delivered in B&W. Tells you that icon is green. PDF online, color is free. Says company doesn't care.
  • ePinions You don't want this about your stuff. Won't help marketing. David Pogue in NY Times: Will say “Don't buy because I can't figure it out and it has a bad manual.” So one of your goals might be to avoid this kind of publicity.
  • Oxygen doc, XML development tool and authoring platform. Formatting is functional. Info is about something that isn't part of Oxygen, but Oxygen supports it. This provides additional supporting info, helps prevent support calls. Providing users with useful background info. Going beyond documenting your features.
  • Having said all that, we need to touch on something Mark Baker said a few months ago. Content strategy must be tied to revenue.
  • Let's talk about money. Think about money and your business goals. If you have regulatory requirements, you don't want to violate them and get sued or shut down... Company positioning, look at marketing analytics, see your results If you're looking to reduce support costs, you'll have to quantify them.
  • Here are some business goals. Why do you have TechDoc and what does it add to your company? If your answer is “because they pay me to do it.” you don't have a content strategy. User communities and loyalty. Programming tools, libraries. What it your organization's justification for tech comm.
  • Once you have your business goals, then you can set your strategy. “We need a book” is not a strategy...unless a 3 rd party book is required. If Consumer produce, your goal might be to: reduce returns, install guide in box, help, wizard. Once you've determined what your goals are, what do you need to do to accomplish that?
  • Most common approach is , “well, I have ________” Let me see what it can do. Do not pick a tool because it's shiny, then figure out strategy. Figure out strategy first, then find tool. SW product vendors will try to convince you their tool is the best in the universe. Buy it, then we'll see what we can do to configure it. Every tool has constraints. Q is: are those constraints acceptable? Purpose of marketing is to frame the question in such a way that your product is the only possible answer.
  • It's your responsibility to figure out what your goals are and what your strategy should be. And from that work your way down to figure out what the solution should be.
  • Find business goal (reduce tech support costs, whatever) Set Strategy (for getting fewer people to call us.) Some obnoxious strategy: make people wait an hour for tech support. More reasonable might be: make content available on web and Google searchable. If question is “lower support costs” the answer should never be “buy this tool.”
  • Give customers lots of ways to access information (web, eBooks, paper, PDF). If regulated, strategy should be deliver content that complies. Improving marketing position, deliver content that's pretty.
  • What you don't want to do is stuff like this. “You can download our PDFs...but first...” Put in your e-mail (optional is hidden at end of sentence). Why are free PDFs hiding behind this download page?
  • Once you have a strategy (and hopefully it won't be one that irritates potential customers), Then you're going to need some tactics. This is the close-up stuff. Implementation, tools, technology.
  • All the things to do what you're trying to accomplish
  • Q is How do we get there from here? Strategy and vision of end result. How do you get there? Here's where you start to hear about project planning, project mgmt, management consulting. Needs analysis, gap analysis, What do we need, where are we now, What info arch do we need? What structure of content? (not necess XML) Planning (Planning is your friend). Pick tools and technologies.
  • NOW you can think about tools & technology. If your favorite tool will do it, fine. Hear a lot that “I have no budget, so I need something cheap.” Business case first, then budget. With savings in business case, you can request budget. We don't ask for much in TechComm. This is a challenge for us in working with clients. $2M localization, 30% DTP cost. If we can save that 30%, you've got money. Diff from “can I have $50,000?”
  • Will be some constraints. Financial: can work around with business case. Organizational: eg high security org didn't want SW from some countries. Regulatory: if Gov says, deliver this format, better do it. Be aware of interpretation: look closely at requirements (does it really say PDF?). Legal: High stakes docs (medical) Corporate culture: Linux only shop, or Open source only (or NO open source). going against corporate culture is difficult.
  • Take these factors, and within them, is your solution.
  • We do advise you to choose wisely. Because if you don't choose the right tool or the right way to implement your strategy, you can run into serious problems.
  • Sometimes the mismatch is obvious. If you're in the middle of the desert, this isn't the solution. In general, not that a particular tool is always wrong or always right; what are your constraints?
  • aka Black Swans There IS an asteroid out there. It will hit your department, or work group, or strategy sooner or later. Represents Disruptive Change . Don't know when, how big, where it's coming from, what it will affect, Can't expect, can't plan for them, can't prevent it. Have to account for them. Change in Regulatory environment New format comes on scene. Just have to deal. What if assumptions are wrong?
  • What's the best delivery format? What's the best way to create it? What content should be in it? This is “best”. What is “best”? Cheapest? Most efficient? Depends. Case-dependent.
  • Risk. Any technology or tool is risky. Kind of risks you'll run into and difficulties are different for different organizations. Business case, if solid, perhaps take some more risks. If weak, perhaps take fewer. Writers are less or more adventurous. Can they handle high-end, tecchie system? “Organizational competencies” - skill level in org. Gap between skill level and where you need them to go, bigger risk.
  • Different SW vendors focus on diff risks. depending on which they are strongest in. Huge mkt share will tell you small mkt share is risky. Leading edge tech will tell you old tech is risky. They have risks they can minimize. Those aren't the questions. (next slide)
  • Q is: what is YOUR biggest risk. Which ones are you willing to take? Which ones are you NOT willing to take. What risk type is most relevant to you?
  • The bottom l ine is: business value must drive strategy. In consulting, we see all sorts of cases: See people who shy away from a solution because it's expensive, but they can't envision the returns. Others are eager for expensive solutions, when the returns aren't there.
  • If you have a strong business case, you can take on any technology. If your business case is weak, you need to keep your technical challenges low. Level of technical challenge must track with the business case
  • So much to do, day to day, get deliverables out the door, deadlines, hard to take big picture view. Our customer usually have a big picture idea of what they need, they have an idea of what their strategy needs to be. But they don't have time to put together the business case, write the strategy, hard to step back. This is hard to do, but we're here to help. There are wonderful consultants out there and you should hire us all.
  • Transcript

    • 1. Content Strategy in Technical Communication Simon Bate Scriptorium Publishing
    • 2. About me
      • Simon Bate
      • 3. Sr. Technical Consultant at Scriptorium
      • 4. Certified Technical Trainer
      • 5. 30+ years Tech Comm experience
    • 6. About Scriptorium
      • Content Strategy for Technical Communication
      • 7. Analyze
      • 8. Develop strategy
      • 9. Implement
      • 10. Transform
      • 11. Train
    • 12. Content Strategy is...
      • “The practice of planning for content creation, delivery, and governance” – Kristina Halvorson (@halvorson)
      • 13. “A repeatable process or methodology that manages content within the entire content lifecycle” – Rahel Bailie
    • 14. Or this... Develop Deliver Destroy Deploy
    • 15. Develop
    • 20. Deliver
      • (or “Deliverables”)
      • 21. Determine deliverable formats
      • 22. Generate deliverables from content
    • 23. Deploy
      • Distribute to a public web server
      • 24. Package in a software build
      • 25. Send to printer and ship to customers
      • 26. Manage access restrictions
    • 27. Destroy
    • 31. What's different about tech comm content strategy?
      • Web content strategy: persuasive content
      • 32. Tech comm: technology transfer
      • 33. “Buy our stuff” versus “use our stuff”
    • 34. Wandering in the desert... flickr: joni1973
    • 35. Step 1: Determine business goals for tech comm content
      • Regulatory requirements
      • 36. Company positioning
      • 37. Avoid more expensive support options
      • 38. Marketing
    • 39. Legal priorities 20% of front page
    • 40. Strong branding
    • 41.  
    • 42. Do not adjust your TV...
    • 43. This probably doesn't help sales...
    • 44. Reduce support calls...
    • 45. What he said. Twitter: @mbakeranalecta, November 12, 2011
    • 46. flickr: Michael Francis McCarthy
    • 47. Business goal examples
      • Meet regulatory requirements
      • 48. Reduce volumes of support calls
      • 49. Avoid legal exposure
      • 50. Increase product market share by highlighting feature set
      • 51. Increase product visibility
      • 52. Build user community and thus loyalty
    • 53. Step 2: Strategy flickr: Rudy Letsche
    • 54. The more common (and bad) approach
    • 58. It's your responsibility flickr: Michael Gwyther-Jones
    • 59. A better way...
    • 64. Strategy examples
      • Provide customers with multiple ways to access needed information
      • 65. Embed information in software
      • 66. Deliver content that complies with regulations (duh)
      • 67. Deliver attractive content for improved marketing positioning
    • 68. We hate you now.
    • 69. Step 3: Tactics
    • 70. Step 3: Tactics
    • 73. How do we get there from here? flickr: aigle_dore
    • 74. Tools & technology flickr: casarico
    • 75. Constraints flickr: quinnanya
    • 80. Think inside the box? Skills Legal Risk Budget Regulations Culture Organization Possible Solutions
    • 81. Choose wisely... flickr: prilfish
    • 82. The wrong tool means big trouble! flickr: antarcticabound
    • 83. The asteroid is coming flickr: edsweeney
    • 84. Determining tactics
      • Best delivery format?
      • 85. Best way to create that format?
    • 86. All technology is risky flickr: mockstar
    • 87. Risk types
      • Implementation risk
      • 88. Obsolescence
      • 89. Market share
      • 90. Technical deficiencies
    • 91. Pick your poison flickr:
    • 92. Business value must drive strategy flickr: zoomzoom
    • 93.  
    • 94. You need a different perspective flickr: Aunt Owwee
    • 95. Summary
      • Business goals come first
      • 96. Content strategy is shaped by goals
      • 97. Choose tools carefully and wisely
      • 98. Understand risk is inherent
    • 99. Questions?
    • 100. Contact information