{"id":24829,"date":"2013-06-03T14:30:34","date_gmt":"2013-06-03T18:30:34","guid":{"rendered":"https:\/\/inalj.com\/?p=24829"},"modified":"2015-08-01T14:53:24","modified_gmt":"2015-08-01T19:53:24","slug":"18-tips-for-writing-a-manual-for-work","status":"publish","type":"post","link":"https:\/\/inalj.com\/?p=24829","title":{"rendered":"18 Tips for Writing a Manual for Work"},"content":{"rendered":"

by Holly Lipschultz <\/em><\/p>\n

18 Tips for Writing a Manual for Work<\/strong><\/span><\/p>\n

I\u2019m one of those Hermione-types of people who read manuals. If I need to learn something, my first order of business is to read the manual. Give me a job manual, and I\u2019ll read by tomorrow morning. And if there is no manual or no instructions\u2014I will write one.<\/p>\n

So, I suppose it shouldn\u2019t be a surprise that I found myself in the situation of creating a full-on Circulation manual for our student workers. We had a lot of old documentation that needed updating, scattered around our staff web. We also had a lot of useful information scattered around both the staff web, the library\u2019s official website, and my work computer left by my predecessors. And a great deal of things were not<\/i> written down anywhere. Institutional memory can be very powerful\u2026and overwhelming to a new person.<\/p>\n

I received advice from my bosses, asked for tips and assistance from friends, and taught myself so many of the functions of Word that I didn\u2019t even know existed. Here are some things I learned about creating workplace documentation, and I hope it helps you.<\/p>\n

1)\u00a0\u00a0 Start by listing everything that the person in the job needs to know. <\/strong>It will take a few days to compile the list. Ask coworkers, bosses, and subordinates. Continue adding to this list even after you start writing.<\/p>\n

2)\u00a0\u00a0 If there is a training outline, use that as a starting point.<\/strong>\u00a0 If there is no training outline, write one. This will become the outline for the manual.<\/p>\n

3)\u00a0\u00a0 Organize it in a logical, training sort of way.<\/strong> Start with the basics and work your way to the more complicated stuff. This varies from library to library. At mine, it made sense to start with an overview of privacy policies before talking about circulating materials. I\u2019m ending with our access policies and alarm systems.<\/p>\n

4)\u00a0\u00a0 Separate it into chapters and subsections<\/strong> like \u201cCheck Out\u201d and then \u201cLooking up patrons,\u201d \u201cDealing with blocks and notices\u201d and \u201cPaying fines.\u201d<\/p>\n

5)\u00a0\u00a0 Use Word\u2019s Table of Contents<\/a> tool.<\/strong> This will save you a LOT of time. Include all of the heading levels you are using. I use 5 levels of headings. Some sections need more subheading levels than others.<\/p>\n

6)\u00a0\u00a0 Learn how to format the ToC<\/strong> to make it easier to read. I like to use bigger fonts for the main chapters, and use subsequently smaller fonts for each subsection (no smaller than 10pt). The directions are in the above link.<\/p>\n

7)\u00a0\u00a0<\/strong> If it is a rather large manual, it is useful to have a partial ToC<\/a> <\/strong>for each chapter for faster look-up.<\/p>\n

8) Use Word headings<\/a> for the titles<\/strong> of each section. You can edit the formatting of the headings to fit your library\u2019s standards.<\/p>\n

9) Learn how to use page and section breaks<\/a>.<\/strong> You can break pages so that each section starts on an odd numbered page, making it easier to find each section.<\/p>\n

10) Give the title and the partial ToC of each section its own full page for a cleaner look,<\/strong> starting the actual content on the following page.<\/p>\n

11) Be thorough with the directions.<\/strong> Don\u2019t assume the person knows something that seems simple to you. For example, not everyone knows how to mark books as \u201clost,\u201d or which drop down menu that option lives in.<\/p>\n

12) On the flip side, don\u2019t include the simplest of tasks.<\/strong> Otherwise it will bog down and bury the actual useful stuff.\u00a0 For example- hold book in your hands does not need to be said.<\/p>\n

13) Include screen shots of processes<\/strong>, actually going through examples yourself if at all possible. Seeing pictures can help make it easier to understand the directions. (Don\u2019t forget to edit out any identifying details of patrons if applicable. I frequently used my own account as an example.)<\/p>\n

14) But don\u2019t use too many pictures.<\/strong> That\u2019s about as helpful as no pictures at all.<\/p>\n

15) Have coworkers and bosses read through<\/strong>, edit, and add suggestions to your manual. Comments<\/a> are your friend. Regular in-person meetings help, too.<\/p>\n

16) I do not recommend including passwords.<\/strong> Keep that in a separate place.<\/p>\n

17) Make a project timeline, like a Gantt chart.\u00a0<\/strong> I made one using Excel, and I can\u2019t tell you how much that helps to keep me motivated. Mine looked a lot like this.<\/a><\/p>\n

18) Give yourself plenty of time<\/strong> when estimating how much time it will take to finish each section. It\u2019s better to finish a section early than it is to ask for extensions. Account for vacations, sick time, work emergencies, finals and midterms, and so on.<\/p>\n

Writing a manual pretty much from scratch can feel overwhelming, but I hope this list helps you feel more empowered!<\/p>\n

Holly Lipschultz lives in Chicago with her husband and three cats, and currently works at an academic library. She writes about disabilities services and other library-related things on her blog.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

by Holly Lipschultz 18 Tips for Writing a Manual for Work I\u2019m one of those Hermione-types of people who read manuals. If I need to learn something, my first order of business is to read the manual. Give me a job manual, and I\u2019ll read by tomorrow morning. And if there is no manual or…<\/p>\n

Read more \u2192<\/a><\/p>\n","protected":false},"author":9,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[145],"tags":[233,3592,4496,3849,3609,4498,4497],"class_list":["post-24829","post","type-post","status-publish","format-standard","hentry","category-articles","tag-articles-2","tag-blog","tag-circulation-manual","tag-holly-lipschultz","tag-inalj-illinois","tag-project-planning","tag-workplace-manual"],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p1WoMK-6st","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/inalj.com\/index.php?rest_route=\/wp\/v2\/posts\/24829","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/inalj.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/inalj.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/inalj.com\/index.php?rest_route=\/wp\/v2\/users\/9"}],"replies":[{"embeddable":true,"href":"https:\/\/inalj.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=24829"}],"version-history":[{"count":0,"href":"https:\/\/inalj.com\/index.php?rest_route=\/wp\/v2\/posts\/24829\/revisions"}],"wp:attachment":[{"href":"https:\/\/inalj.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=24829"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/inalj.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=24829"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/inalj.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=24829"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}