Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

AnchortoptopSummary: This page includes a summary of our process and timeline for document functions as an archive of the 2017-2018 overhaul of TS documentation, some resources and tools we used, and the checklists project to examine and improve the policies and procedures documentation at MSU Libraries in the Technical Services Division. Included are resources, tools, presentations, checklists, and decisions that guided our workthe project.


Table of Contents
printablefalse

Note

This page is an example of the long-form procedures template, which includes a summary section at the top, a linked table of contents for quick travel to specific sections, rule lines between each procedural section or step for good visual cues and linear progression, and right-hand boxes for any relevant polices and for administrative information about the page itself.

Step 1

  • Substep a

  • Substep b
  • Substep c

    Prelude to a Project

    Before we launched our project, the libraries’ public-facing Drupal website was the repository for TS documentation. This aligned with the overall land-grant mission of the university, but it resulted in some logistical challenges, such as searching – which couldn’t be focused in strictly to TS content.

    The documentation had been handed down through multiple editors and migrated across several intranet and wiki iterations. This understandably resulted in disjointed organization, duplicated pages, and outdated or conflicting information. It had also ballooned to a whopping 300 + pages. Finding information could be challenging and often required knowledge on what team performed what function – or sometimes used to perform it. The procedures had been maintained as well as could be expected, but had reached the point at which a concentrated, holistic assessment was necessary.

    For context, in 2017, MSU Libraries Technical Services Division employed approximately 40 FTE, all of whom are based in the Main Library building. It is comprised of seven sub-units: Acquisitions, Catalog Maintenance, Cataloging & Metadata Services, Copy Cataloging, Metadata Management (authorities work), Catalog Services (system management of the integrated library system, or ILS), and Electronic Resources.

    We launched the project believing that good documentation creates a better working environment. Just like other forms of workplace communication, documentation is a part of staff empowerment because it allows for equal access to information, reduces cognitive load (which negates mistakes), and supports confident and independent decision making. Technical Services work is detailed and highly structured by its nature. And we believe there is a direct line from good documentation to quality work.

    Autumn Faulkner and Emily Sanford were the primaries on the project and were later joined by Tim Kiser. The project began in 2017 and concluded with the launch of a Confluence site on May 15, 2018.

    Back to top 

    Step 2

    Project Plan and Goals

    • Substep a

    • Substep b

    • Substep c

    Back to top

    Step 3

    Substep a

    Initial Assessment

    Back to top


    Step 4

    • Substep a

    • Substep b

    • Substep c

    Back to top


    Panel
    borderColorblack
    bgColor#F8F8F8
    borderWidth1
    titlePolicies
    borderStylesolid
    titlePolicies

    This panel was designed for policies, in recognition of the fact that policies are a different type of content from procedures, and should be parsed out and presented uniformly. 

    This supports quick scanning and navigation for readers searching for specific pieces of informationAutumn – should we say something here about creative commons, etc? Or usage, etc.


    Page Properties
    idpage-info


    Contact

    Autumn Faulkner

    Team

    CMS

    Updated

    May

    July 2020

    Created

    May 2020