{"id":4504,"date":"2015-05-11T11:50:07","date_gmt":"2015-05-11T16:50:07","guid":{"rendered":"http:\/\/www.encoretechresources.com\/insights\/?p=4504"},"modified":"2015-05-11T11:50:07","modified_gmt":"2015-05-11T16:50:07","slug":"writing-that-gets-you-from-here-to-there-now-as-then","status":"publish","type":"post","link":"http:\/\/www.encoretechresources.com\/insights\/2015\/05\/11\/writing-that-gets-you-from-here-to-there-now-as-then\/","title":{"rendered":"Writing That Gets You From Here to There \u2013 Now as Then"},"content":{"rendered":"<p>Tom Johnson, a technical writer in San Jose, CA, has the right idea: He wants to be sure that technical writing is focused on the reader (that is, the user), not the equipment or processes being explained. They&#8217;re obviously important, but the reader is moreso. He or she has got to get it right \u2013 and readily so.   <\/p>\n<p><a href=\"http:\/\/www.encoretechresources.com\/insights\/wp-content\/uploads\/images7.jpg\"><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/www.encoretechresources.com\/insights\/wp-content\/uploads\/images7.jpg\" alt=\"images\" width=\"177\" height=\"285\" class=\"alignnone size-full wp-image-4510\" \/><\/a>Tom has <a href=\"http:\/\/idratherbewriting.com\/2015\/04\/23\/new-series-user-centered-documentation\/\">started a new series<\/a> on his I&#8217;d Rather Be Writing blog on user-centered design. That&#8217;s what all good writing should be: user-, that is, reader-, centered. It&#8217;s not the equipment or location that&#8217;s benefitting from clarity of expression \u2013 except residually (it can be damaged) \u2013 but the reader who&#8217;s seeking to use it properly. And he or she may be in too much of a hurry.<\/p>\n<p>All good writing puts the reader foremost. Not that writing needs to be overly simplified, but it needs to be engaging \u2013 or, in the case of technical writing, readily decipherable. <\/p>\n<p>Tom Johnson has spent some time in usability labs watching users interact with his content and, he says, &#8220;it&#8217;s an eye-opening experience.&#8221; He&#8217;s got some links in his post relating to the labs, but he&#8217;s distilled 12 patterns from them. They include recognizing that users are often in a hurry, that they like visuals and that they don&#8217;t necessarily read in sequential order. <\/p>\n<p>Meeting such human desires is indeed a challenge to technical writers, but those are your publics \u2013 human beings under pressures.<\/p>\n<p>Tom Johnston writes not not so much about instructions for physical products as software documentation, which is his gig. Yet clarity applies as much to today&#8217;s cyber settings as it did to Thomas Hardy&#8217;s Wessex novels. <\/p>\n<p>Tom Johnson urges his tech writing colleagues to design their documentation around his perceived patterns of user behavior. In listing them, he&#8217;s done a lot of your work for you. Take advantage of his accomplishments. \u2013 <em>Doug Bedell <\/em> <\/p>\n<p><em>(Illustration: Simon Gatrell&#8217;s book &#8220;Thomas Hardy&#8217;s Vision of Wessex&#8221;)<\/em> <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Tom Johnson, a technical writer in San Jose, CA, has the right idea: He wants to be sure that technical writing is focused on the reader (that is, the user), not the equipment or processes being explained. They&#8217;re obviously important, but the reader is moreso. He or she has got to get it right \u2013 [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8,3,5],"tags":[],"class_list":["post-4504","post","type-post","status-publish","format-standard","hentry","category-communication","category-technology","category-the-writing-life"],"aioseo_notices":[],"_links":{"self":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/4504"}],"collection":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/comments?post=4504"}],"version-history":[{"count":10,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/4504\/revisions"}],"predecessor-version":[{"id":4516,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/4504\/revisions\/4516"}],"wp:attachment":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/media?parent=4504"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/categories?post=4504"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/tags?post=4504"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}