{"id":475,"date":"2017-07-12T11:34:39","date_gmt":"2017-07-12T11:34:39","guid":{"rendered":"https:\/\/www.precisioncontent.com\/blog\/?p=475"},"modified":"2017-07-13T19:20:44","modified_gmt":"2017-07-13T19:20:44","slug":"addressing-dita-dissatisfaction-part-1-skills-development","status":"publish","type":"post","link":"https:\/\/www.precisioncontent.com\/blog\/addressing-dita-dissatisfaction-part-1-skills-development\/","title":{"rendered":"Addressing DITA Dissatisfaction Part 1: Skills Development"},"content":{"rendered":"<p><img loading=\"lazy\" class=\"size-full wp-image-591 aligncenter\" src=\"https:\/\/www.precisioncontent.com\/blog\/wp-content\/uploads\/2017\/07\/banner_skills.png\" alt=\"banner_skills\" width=\"912\" height=\"384\" srcset=\"https:\/\/www.precisioncontent.com\/blog\/wp-content\/uploads\/2017\/07\/banner_skills.png 912w, https:\/\/www.precisioncontent.com\/blog\/wp-content\/uploads\/2017\/07\/banner_skills-300x126.png 300w, https:\/\/www.precisioncontent.com\/blog\/wp-content\/uploads\/2017\/07\/banner_skills-768x323.png 768w\" sizes=\"(max-width: 912px) 100vw, 912px\" \/><\/p>\n<p><em>By Rob Hanna \u2013 President of Precision Content<\/em><\/p>\n<p><em>This article is part of a series based on the results of a survey of more than 250 technical communication professionals conducted by The Content Wrangler in 2017 entitled The DITA Satisfaction Survey<a href=\"#_edn1\" name=\"_ednref1\">[i]<\/a>. In the survey, almost two-thirds of respondents voiced concerns with their DITA deployment.<\/em><\/p>\n<p>In our previous article, we introduced the overall results from the survey that pertain to users\u2019 dissatisfaction with their DITA solution. In this article, we examine the top rated issues pertaining to skills development.<\/p>\n<h1><strong><br \/>\nIssues related to skills development<\/strong><\/h1>\n<p>The top-ranked reported issues fall under the category of skill development and training. These include<\/p>\n<ul>\n<li>How do I reuse content? Ranked 1<span style=\"font-size: 13.3333px;\">st<\/span> by 75% of respondents<\/li>\n<li>How do I make DITA do what I want it to do? Ranked 2nd by 69% of respondents<\/li>\n<li>Where can I get DITA training? Ranked 3<span style=\"font-size: 13.3333px;\">rd<\/span> by 64% of respondents, and<\/li>\n<li>How do I create DITA content? Ranked 8<span style=\"font-size: 13.3333px;\">th<\/span> by 56% of respondents.<\/li>\n<\/ul>\n<p>This problem area is far and away the most pressing obstacle for a successful DITA deployment. Too often authors are left to figure out how to adapt to writing for DITA on their own. Organizations will normally invest in tools training\u2014and may even opt for a short training course to learn about DITA\u2014but they rarely make the effort to train writers how to author modular, structured topics of content designed for reuse.<\/p>\n<p>It is easy to overlook this training aspect and assume that writers will naturally adapt to this new way of writing. But, those assumptions can lead to big problems.<\/p>\n<p>In a poll conducted in a recent webinar<a href=\"#_edn2\" name=\"_ednref2\">[ii]<\/a> where half of the participants indicated they were already using DITA, a full 70% indicated that they had no formal DITA training. Of those participants, nearly 60% were self-taught while the others had no training at all. It\u2019s no wonder that dissatisfaction is the norm.<\/p>\n<h1><strong><br \/>\nSelecting the best training for your needs<\/strong><\/h1>\n<p>There are many training options available to learn about DITA. Selecting the best training for your team entails examining what it is you need to learn. Most DITA training courses cover the features and walk you through the structures and mechanics of the standard. These courses demonstrate how to markup content, but will often not teach you how to rethink and restructure your content to take advantage of DITA\u2019s features. Consider the differences between structured writing and structured markup.<\/p>\n<table class=\"table table-bordered\" border=\"0\" width=\"100%\" cellspacing=\"0\" cellpadding=\"0\">\n<tbody>\n<tr>\n<td valign=\"top\" width=\"50%\"><strong>Structured Writing\u00a0<\/strong><\/td>\n<td valign=\"top\" width=\"50%\"><strong>Structured Markup<\/strong><\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n<ul>\n<li>Coined by Robert Horn in the 1960\u2019s as a means of <em>analyzing, organizing, and presenting <\/em>information for optimal human consumption<\/li>\n<\/ul>\n<\/td>\n<td valign=\"top\">\n<ul>\n<li>Allows authors to markup words, phrases, and sections of content <em>for<\/em> <em>presentation and for meaning<\/em> for consumption by machines<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n<ul>\n<li>Promotes <em>patterns for format and syntax <\/em>that become easily recognizable and predictable<\/li>\n<\/ul>\n<\/td>\n<td valign=\"top\">\n<ul>\n<li>Is validated using <em>standard sets of rules <\/em>that specify consistent and predictable patterns<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n<ul>\n<li>Relies on consistently <em>labelling and chunking <\/em>information into easily scannable text<\/li>\n<\/ul>\n<\/td>\n<td valign=\"top\">\n<ul>\n<li>\u00a0Specifies what content goes where but\u00a0<em>does not limit or restrict how the content is written<\/em><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td valign=\"top\">\n<ul>\n<li>Introduces universal\u00a0<em>information typing\u00a0<\/em>based on intended reader response<\/li>\n<\/ul>\n<\/td>\n<td valign=\"top\">\n<ul>\n<li>Provides a rich underlying\u00a0<em>metadata layer <\/em>for capturing properties related to the content<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><em>Table reproduced from \u201cDriving Enterprise Productivity from the Front of the DITA XML Train<a href=\"#_edn3\" name=\"_ednref3\">[iii]<\/a>\u201d.<\/em><br \/>\n<strong><br \/>\n<\/strong><\/p>\n<h1><strong>Continuous collaborative learning<\/strong><\/h1>\n<p>Organizations that wisely invest in comprehensive training for their writing teams also recognize the importance of continuous learning and recurring training. To stay on top of knowledge sharing in your team, consider the following collaboration activities:<\/p>\n<ul>\n<li>Schedule regular checkpoints where your team discusses what they\u2019ve learned with other members of the team.<\/li>\n<li>Assign different members of your team to research and present best practices at regularly scheduled lunch-and-learn sessions.<\/li>\n<li>Attend webinars and seminars on best practices as a group and then debrief together to discuss aspects that should be incorporated into your day-to-day work.<\/li>\n<li>Review and update your content standards regularly as a team to keep your procedures and guidelines current and relevant.<\/li>\n<li>Pair up senior members of your team with new or junior members for regular mentoring and coaching.<strong>\u00a0<\/strong><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h1><strong>Precision Content\u00ae Structured Author Training<\/strong><\/h1>\n<p>Precision Content has many years of experience teaching organizations how to write better structured content. Our inhouse, instructor-led training courses run from 1 to 5 days depending on your needs and cover the gamut of tools and techniques needed for successful structured authoring. Learn more about our <a href=\"https:\/\/www.precisioncontent.com\/how-we-help-you\/training\" target=\"_blank\">DITA training<\/a>. Or contact Precision Content to find out more about how we can address your specific training needs.<\/p>\n<h3>Other Posts in this series<\/h3>\n<ul>\n<li><a href=\"https:\/\/www.precisioncontent.com\/blog\/are-you-satisfied-with-your-dita-solution\/\">Are you satisfied with your DITA solution?<\/a> -The 2017 Content Wrangler DITA Satisfaction Survey asked respondents to rank the top 10 issues facing DITA users. Learn more about the survey and results.<\/li>\n<li><a href=\"https:\/\/www.precisioncontent.com\/blog\/addressing-dita-dissatisfaction-part-2-technology\/\">DITA Dissatisfaction Part 2: Technology<\/a> &#8211; We often hear about the failure of the technology as it relates to performance or complexity. While technology may seem the most likely culprit, it is often not the root cause of the problem.<\/li>\n<li><a href=\"https:\/\/www.precisioncontent.com\/blog\/addressing-dita-dissatisfaction-part-3-management\/\">DITA Dissatisfaction Part 3: Management<\/a> &#8211; While these issues appear to be of least concern to many survey respondents, they are most likely to form the root cause of all other issues identified in the survey. This points to a general lack of awareness as to the role management should be playing in collaborative, structured authoring solutions.<\/li>\n<\/ul>\n<h3>Footnotes<\/h3>\n<p><a href=\"#_ednref1\" name=\"_edn1\">[i]<\/a> DITA Satisfaction Survey published by The Content Wrangler on May 31, 2017. Listen to an analysis of the results by Rob Hanna, Keith Schengili-Roberts, Mark Lewis, and Scott Abel and download a copy of the results today from BrightTalk at <a href=\"https:\/\/www.brighttalk.com\/webcast\/9273\/259775\">https:\/\/www.brighttalk.com\/webcast\/9273\/259775<\/a><\/p>\n<p><a href=\"#_ednref2\" name=\"_edn2\">[ii]<\/a> The Cognitive Science Behind Intelligent Content presented by Rob Hanna on July 21, 2016. See <a href=\"https:\/\/www.brighttalk.com\/webcast\/9273\/214245\">https:\/\/www.brighttalk.com\/webcast\/9273\/214245<\/a> for details.<\/p>\n<p><a href=\"#_ednref3\" name=\"_edn3\">[iii]<\/a> Driving Enterprise Productivity from the Front of the DITA XML Train presented by Rob Hanna and Doug Gorman at DITA North America 2017 in San Diego, CA.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>By Rob Hanna \u2013 President of Precision Content This article is part of a series based on the results of a survey of more than 250 technical communication professionals conducted by The Content Wrangler in 2017 entitled The DITA Satisfaction Survey[i]. In the survey, almost two-thirds of respondents voiced concerns with their DITA deployment. In [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":551,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false},"categories":[7,6],"tags":[],"_links":{"self":[{"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/posts\/475"}],"collection":[{"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/comments?post=475"}],"version-history":[{"count":40,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/posts\/475\/revisions"}],"predecessor-version":[{"id":567,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/posts\/475\/revisions\/567"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/media\/551"}],"wp:attachment":[{"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/media?parent=475"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/categories?post=475"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.precisioncontent.com\/blog\/wp-json\/wp\/v2\/tags?post=475"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}