{"id":1641,"date":"2011-07-11T12:00:39","date_gmt":"2011-07-11T17:00:39","guid":{"rendered":"http:\/\/www.encoretechresources.com\/insights\/?p=1641"},"modified":"2011-07-15T15:50:16","modified_gmt":"2011-07-15T20:50:16","slug":"keep-repetitive-learning-up-front","status":"publish","type":"post","link":"http:\/\/www.encoretechresources.com\/insights\/2011\/07\/11\/keep-repetitive-learning-up-front\/","title":{"rendered":"Keep Repetitive Learning ‘Up Front’"},"content":{"rendered":"

\"\"<\/a>Scott Nesbitt, a technical writing colleague on the Web, raises an interesting question<\/a>: How do we write manuals or procedures with steps that might involve repetitive skills or insights without bogging the reader down?<\/p>\n

Repetition, Scott notes, is an effective way of learning but “it gets tedious quite quickly.” So how do we keep procedures from working against themselves by inflicting too much cross-referencing on the reader?<\/p>\n

A good question. I haven’t talked with Dennis Owen about this, but he can chime in whenever he pleases. <\/p>\n

An approach that occurs to Scott is to state something like this af the beginning of a procedure:
\n<\/p>\n

“To carry out this task, you need to do [whatever] first. If you don’t know or don’t remember how to do that, see [cross reference].<\/p>\n

“For the cross reference, add a link with a pop up or a page reference (depending on how you\u2019re delivering your documentation).”<\/p>\n

There you have it, up front. <\/p>\n

An approach like this can help avoid cross references throughout a text that can slow it down. You still learn, and retain learning, by repetition, but on an up-front basis. Not a bad concept for technical writers to consider. – Doug Bedell<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

Scott Nesbitt, a technical writing colleague on the Web, raises an interesting question: How do we write manuals or procedures with steps that might involve repetitive skills or insights without bogging the reader down? Repetition, Scott notes, is an effective way of learning but “it gets tedious quite quickly.” So how do we keep procedures […]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3,1],"tags":[],"class_list":["post-1641","post","type-post","status-publish","format-standard","hentry","category-technology","category-uncategorized"],"aioseo_notices":[],"_links":{"self":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/1641"}],"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=1641"}],"version-history":[{"count":11,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/1641\/revisions"}],"predecessor-version":[{"id":1674,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/posts\/1641\/revisions\/1674"}],"wp:attachment":[{"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/media?parent=1641"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/categories?post=1641"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.encoretechresources.com\/insights\/wp-json\/wp\/v2\/tags?post=1641"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}