{"id":5153,"date":"2016-08-10T16:41:18","date_gmt":"2016-08-10T21:41:18","guid":{"rendered":"http:\/\/www.encoretechresources.com\/insights\/?p=5153"},"modified":"2016-08-10T16:41:18","modified_gmt":"2016-08-10T21:41:18","slug":"technical-writings-about-reality","status":"publish","type":"post","link":"http:\/\/www.encoretechresources.com\/insights\/2016\/08\/10\/technical-writings-about-reality\/","title":{"rendered":"Technical Writing’s About Reality"},"content":{"rendered":"

\"images\"<\/a>
\nSo what’s the most important trait of a technical writer?<\/p>\n

Sharon Burton answers<\/a>, no surprise here, that “I can teach someone to write. I can give them the Good Writing Guidelines, I can set up a structure that they need to follow to create topics. I can teach the basics of any tool we choose. I can teach them about audience and what the audience needs and how that impacts us.<\/p>\n

“What I can\u2019t teach is the curiosity to ask questions, to poke at the product, to constantly ask ‘What if\u2026?'” If you consider a technical writer to be an investigator<\/em>, not merely a writer, as you should, the capacity to inquire and discover is his or her paramount skill. After all, the procedures produced have to be on-the-mark in a highly utilitarian way.<\/p>\n

A technical writer has to be sure that he or she is describing reality as it exists and curiosity is necessary to insure that reality has been captured accurately, safely and unfailingly in words for others to follow. Technical writing is good, faithful guidance. <\/p>\n

“Non-curious means you just want to format information other people give you,” Sharon Burton writes. And that’s not going to help anyone, least of all your users.”<\/p>\n

So be sure you accept that technical writers produce ever-reliable information for path-finding, hard information about step-by-step reality. That’s it, folks. \u2013 Doug Bedell <\/em>
\n(Image \u2013 TechWhirl.com)<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

So what’s the most important trait of a technical writer? Sharon Burton answers, no surprise here, that “I can teach someone to write. I can give them the Good Writing Guidelines, I can set up a structure that they need to follow to create topics. I can teach the basics of any tool we choose. […]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4,3,5],"tags":[],"class_list":["post-5153","post","type-post","status-publish","format-standard","hentry","category-business","category-technology","category-the-writing-life"],"aioseo_notices":[],"_links":{"self":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/5153"}],"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=5153"}],"version-history":[{"count":5,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/5153\/revisions"}],"predecessor-version":[{"id":5159,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/5153\/revisions\/5159"}],"wp:attachment":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/media?parent=5153"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/categories?post=5153"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/tags?post=5153"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}