Need to reboot your content creation strategy? Start with "No"

Embed Size (px)


Learn how the Windows 8 team determined their content strategy, and the principles they adopted to maximize their content resources.

Text of Need to reboot your content creation strategy? Start with "No"

  • 1. Need to Reboot Your Content Creation Strategy? Start with "No" Keith Boyd Microsoft Corporation
  • 2. About me 14 years at Microsoft, all in technical content. 12 years in management. 2000-2013 Windows writer and manager 2013-present Principal Director, Content Services and International (CSI) in the Cloud & Enterprise division (Azure, Visual Studio, .NET) Team owns roughly 10 million content assets as well as the MSDN print and online magazine. Past-president, Western WA University Alumni Association. @Keith_Boyd #LavaCon
  • 3. Staffing vs. platform growth XP Vista Windows 7 Windows 8/8.1 With each release of Windows, the dev platform grew in size-- most dramatically during Windows Vista and Windows 8 development 400 300 200 100 0 500 Programming-Writer population at Microsoft XP Vista Windows 7 Windows 8 Windows 10 while staffing actually *decreased*, somewhat dramatically (values are approximate). Thousands of topics Millions of topics @Keith_Boyd #LavaCon
  • 4. Why did staffing shift so dramatically? Before 2005 there were very few sites detailing how to build Windows apps, services, or drivers. As market forces changed, the balance of personnel investment also changed. Technical communicators failed to consistently demonstrate their value relative to other disciplines. Microsoft didnt need scribes, it needed SMEs. @Keith_Boyd #LavaCon
  • 5. Content innovation vs. fundamentals High $$ Too expensive to be practical for most teams Untenable no team would accept results at this level Innovation Low High Fundamentals Most content teams at Microsoft fell somewhere on the red line, generally doing neither fundamentals or innovation well. No wonder staffing suffered. What to do? @Keith_Boyd #LavaCon
  • 6. Win8: four principles In order to maximize resources and deliver greater value, we adopted four principles: 1.Less is more 2.Code first 3.Embrace a modern voice and tone 4.Be data driven @Keith_Boyd #LavaCon
  • 7. PRINCIPLE: LESS IS MORE Too much content obfuscates and dilutes the important stuff
  • 8. The painful truth 3 primary reasons people come to MSDN: 1. To get the bits, or to provision an account. 2. To Get Started quickly with a product or service. 3. To get help when theyre stuck. Almost no one *wants* to read the content that my team produces. And absolutely no one wants to read a 2000 word conceptual overview when theyre in the middle of coding (much less a 100 page whitepaper!) @Keith_Boyd #LavaCon
  • 9. Minimally viable content Historically, we tried to anticipate everything a dev might need, and produced it. That lead to bloat, since content was created speculatively; not based on articulated customer need. Ironically, right when we started to learn about how customers were actually using our products, we shifted attention to the next version, and began the speculative cycle all over again. For Windows 8, we built minimally viable content for use on day 1, then paid closer attention to how customers actually used our content so we could flesh it out later. @Keith_Boyd #LavaCon
  • 10. What is minimally viable content for the dev audience? It covers all the basics: What the product is, and why youd want it. How to acquire it. How to get started, quickly. API reference, at baseline standards of quality. Code samples for key APIs (not necessarily every API). Breadth information about the features that comprise the product or service. What its not: A compendium of every imaginable scenario associated with the product. An exhaustive, inclusive reference section with deep details. Comprehensive guidance detailing every feature in the product or service. @Keith_Boyd #LavaCon
  • 11. vNow vs. vNext Adopting a minimally viable approach lets your team support users on current products/services better, while still building a viable doc set for day 1 vNow Keeping these forces in balance is critical to our content strategy after all, its the current version of the platform or service that actually pays the bills. vNext @Keith_Boyd #LavaCon
  • 12. Reimagining capacity planning With Windows 8, we centralized content planning. We did this because Not all features or scenarios are created equal. Not all writers (or leads!) are as good at evaluating the relative value of investing in one area against another. Nearly all writers said yes when negotiating with their feature teams (the scribe mentality). By doing this, we started every milestone assuming that new content didnt meet the bar for inclusion (No!). Then we let the writer or scenario owner talk the leadership team into it. @Keith_Boyd #LavaCon
  • 13. Deliberate collaboration Well defined roles helped us work together more effectively to create better content experiences across the customers journey. Data/BI Content Engineering Content Experience Developer Evangelism & Support Content Team Product Marketing Site Management Key scenarios; campaigns; premium content; SEM Scenario flows; content discoverability (SEO); metrics; project management; presentation; organization Content goals, plans and scenarios; execution; IA Product Team Customer advocacy; user stories; competitive insights @Keith_Boyd #LavaCon
  • 14. Enabling customer contribution Content teams at MS have been reluctant to embrace a more open content platform. But times are changing: Resourcing constraints are forcing our hand. In the real world, software and content are built side-by-side, in collaborative fashion (think GITHub). Devs know more about their code than writers. In response, multiple initiatives incent customer participation in content: Curah! curation platform. Soon: Collaborative documentation and better 1st and 3rd party community integration. @Keith_Boyd #LavaCon
  • 15. PRINCIPLE: CODE FIRST (EMPATHY SECOND) When a developer is stuck, they dont want to read, they want code.
  • 16. (Re)Building customer empathy The leadership team recognized that the longer someone worked at Microsoft, the less customer empathy they exhibited. There are a number of reasons for that: Not enough hours in the day to continue to dabble with the technology. Passion gets extinguished its just a job. Loss of perspective due to assimilation into the Microsoft culture. We gave writers so much to do that the skills and attributes that made them such great hires in the first place slowly withered away! How could we rekindle their passion? @Keith_Boyd #LavaCon
  • 17. Embracing code first Answer: write code. 25% of a writers total capacity was reserved so they would: Gain firsthand knowledge of the platform, from the developers perspective. Write more code snippets, which improved the underlying reference content. Spend more time in small development teams building end-to-end samples and solutions (real world development) Test our content when they were coding and got stuck, the rule was they had to use our docs. @Keith_Boyd #LavaCon
  • 18. Benefits of Code first A happier and more productive team. Writing code is fun! More complete and accurate documentation. Bugs were filed when we found omissions or errors. Deeper customer empathy. We developed unique insights of value to peer teams. Additional end