![\"images\"](\"http:\/\/www.encoretechresources.com\/insights\/wp-content\/uploads\/images1.jpg\")
<\/a>Tom Johnson, on his excellent “I’d Rather Be Writing” technical writing blog, deals with the virtues of subheads<\/a> at some depth. Tom took a poll on why “users can’t find answers in help material.” \u00a0And he found that “help is either too long so users can’t find the answer, or help is too short so users can’t find the answer.” So what’s needed is a mechanism to facilitate organizing and scanning a page. (Oh, there’s that “f” word again.) Subheads are the answer both to orderly writing and orderly page layout.<\/p>\nUse subheads, first, to organize material that belongs together and then to draw your reader’s eyes to your handiwork. You’ve made his or her day when it’s easy to follow what you’re presenting. Subheads along with reasonably clear writing are the answer. \u00a0They’re both attractive \u00a0typographically and \u00a0highly utilitarian. (Below a subhead, or instead of one, a “bullet” dot to set off key sentences or paragraphs can also be helpful.)<\/p>\n
A maximum of four indented subheads on a page, as illustrated here, may actually be too many, unless your material is so complex that it requires them. Definitely avoid run-on subheads, as much as run-on writing. The idea is to be organized, not typographically lush.\u00a0Typographical techniques aren’t a substitute for clear, well-organized writing, just helpmates in negotiating your terrain. The eye can be distracted by too many of them.<\/p>\n
“Almost any Wikipedia page provides a great example of subheadings in action,” Tom notes. “There we have many paragraphs of content broken up by subheadings, with a built-in navigation embedded at the top. It\u2019s a model that seems to work well on the web.” Subheads work well on paper, too, if they’re not overdone. Keep them always in mind as your technical writing unfolds. \u2013 Doug Bedell\u00a0<\/em><\/p>\n","protected":false},"excerpt":{"rendered":" Technical writing needs to be orderly, but to insure that it’s read and understood by busy people, it definitely shouldn’t be dense. Aside from writing reasonably short, orderly sentences, adding subheads when the focus changes a bit is a mechanical, but very helpful, way of keeping a reader with you. Subheads are perhaps a tech […]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8,3,5],"tags":[],"class_list":["post-3988","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\/3988"}],"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=3988"}],"version-history":[{"count":6,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/3988\/revisions"}],"predecessor-version":[{"id":3995,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/3988\/revisions\/3995"}],"wp:attachment":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/media?parent=3988"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/categories?post=3988"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/tags?post=3988"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}