{"id":19309,"date":"2019-05-07T11:47:49","date_gmt":"2019-05-07T15:47:49","guid":{"rendered":"https:\/\/community.macmillan.com\/community\/the-english-community\/bedford-bits\/blog\/2019\/05\/07\/a-simple-resource-to-teach-documentation-requirements"},"modified":"2019-05-07T11:47:49","modified_gmt":"2019-05-07T15:47:49","slug":"a-simple-resource-to-teach-documentation-requirements","status":"publish","type":"post","link":"https:\/\/www.tengrrl.com\/blog\/2019\/05\/07\/a-simple-resource-to-teach-documentation-requirements\/","title":{"rendered":"A Simple Resource to Teach Documentation Requirements"},"content":{"rendered":"

In February, I shared a resource I designed to Persuade Students to Think Visually with Infographics<\/a>. I was taken with the \u201cThinking Visually\u201d features in the Bedford\/St. Martin\u2019s textbook Practical Strategies for Technical Communication<\/a><\/em> by Mike Markel.<\/p>\n

This week I\u2019m sharing another resource inspired by the \u201cThinking Visually\u201d feature. The infographic shown below focuses on one basic idea related to documentation and citation\u2013the answer to the question \u201cWhat Do I Need to Document?\u201d It is also available as a Google Doc<\/a> or a PDF<\/a> to provide screen-reader accessible versions.<\/p>\n

\"image\"<\/a><\/p>\n

The infographic is a brief version of the information from Markel & Selber\u2019s Technical Communication<\/em> Appendix on \u201cDocumenting Your Sources\u201d (p. 620). I designed the resource to concentrate on just one concept related to documentation and citation (what to document). The information as it is presented in the Appendix is part of a complete explanation of the relevant topics. Students sometimes miss the key details when so many ideas are being explained. Essentially, I am combating students\u2019 information overload.<\/p>\n

I have paired each category to document with a single icon from The Noun Project<\/a>. Here, I am hoping that the icons will help students remember the categories:<\/p>\n