Skip to main content

SOP Library

Organize the standard documents an operations team relies on day to day, including runbooks, work instructions, troubleshooting guides, and equipment manuals.

How to use this solution

Use this solution as a starting point for an operations knowledge base. Every entry uses the same Document type, with the Document Type field identifying the kind of procedure.

  • Runbooks: Step-by-step response procedures for a triggering event such as an outage, failed job, or incident. They are written so an on-call responder can follow them under pressure.
  • Work instructions: Repeatable procedures for routine operational work, such as packing a shipment or provisioning a badge. They are written for someone performing the task for the first time.
  • Troubleshooting guides: Symptom-driven diagnostic procedures organized around decision points rather than a fixed sequence.
  • Equipment manuals: Operation, safety, and maintenance information for a specific piece of equipment, including routine maintenance intervals.

Using one Document type keeps authoring, searching, and reporting consistent across every category.

How the solution is organized

The solution is built around a single business object:

Business objectWhat it represents
DocumentA runbook, work instruction, troubleshooting guide, equipment manual, or other controlled business document

Document fields

FieldHow it is used
Document NumberLocked, automatically generated identifier in the format DOC-#
Document NameThe title of the Document
Document TypeRunbook, Work Instruction, Troubleshooting Guide, Equipment Manual, or a general type such as Policy, Procedure, Manual, or Specification
OwnerThe person accountable for keeping the Document current
VersionFree-text version identifier, such as 1.0 or 2.1
StatusDraft, In Review, Approved, Active, Expired, or Archived
Effective DateWhen the Document goes into use
Expiration DateWhen the Document needs review
DocumentFull-width rich-text body containing the procedure
FileOptional attachment, such as a vendor-issued PDF manual
NotesSide notes kept separately from the main procedure
CommentsThreaded discussion and review feedback on the record

Included views

The workspace includes seven Views so users can find Documents without creating filters:

ViewWhat it displays
All DocumentsThe complete, unfiltered library
RunbooksDocuments with Document Type set to Runbook
Work InstructionsDocuments with Document Type set to Work Instruction
Troubleshooting GuidesDocuments with Document Type set to Troubleshooting Guide
Equipment ManualsDocuments with Document Type set to Equipment Manual
DraftsDocuments with Status set to Draft
In ReviewDocuments with Status set to In Review

The category Views and status Views display filtered sets of the same underlying Document records.

Getting started

1. Review the sample Documents

Open each of the four category Views to review the worked examples. The sample library contains two Runbooks, two Work Instructions, two Troubleshooting Guides, and two Equipment Manuals written as complete procedures rather than placeholder text.

2. Choose your Document categories

Keep the existing Document Type options, or adjust them to match your organization's categories.

3. Add your procedures

Delete or edit the sample Documents, then add your team's runbooks, work instructions, troubleshooting guides, and equipment manuals.

Write the procedure in the Document field and add a file attachment when the source material is an existing PDF or other document.

4. Assign ownership and review dates

Assign an Owner to each Document and use the Effective Date and Expiration Date to support periodic review.

A Document that remains In Review or passes its Expiration Date needs attention.

5. Use Views to find and review Documents

Use the category Views to browse by Document Type and the Drafts and In Review Views to find Documents that are not yet active.

Included examples

DocumentTypeStatus
DOC-3 Production Database Outage - Incident Response RunbookRunbookActive
DOC-4 Nightly Batch Job Failure - Recovery RunbookRunbookIn Review
DOC-5 Work Instruction: Packing and Labeling Outbound ShipmentsWork InstructionActive
DOC-6 Work Instruction: New Employee Badge ProvisioningWork InstructionActive
DOC-7 Troubleshooting Guide: POS Terminal Won't Connect to NetworkTroubleshooting GuideActive
DOC-8 Troubleshooting Guide: Conveyor Belt Jam DiagnosisTroubleshooting GuideActive
DOC-9 Equipment Manual: Toyota 8FGCU25 Forklift - Operation and MaintenanceEquipment ManualActive
DOC-10 Equipment Manual: Zebra ZT411 Label Printer - Setup and CareEquipment ManualDraft

The Drafts View displays only DOC-10, while the In Review View displays only DOC-4.

Make it yours

This solution is a starting point rather than a fixed structure. Common extensions include:

  • Add a Version History child type when you need a full audit trail of revisions instead of a single Version field.
  • Add an approval workflow that moves a Document from Draft to In Review, Approved, and Active, or notifies the Owner when a Document nears its Expiration Date.
  • Add a reference field that links an Equipment Manual to an Equipment or Asset record when physical assets are tracked elsewhere.
  • Publish a read-only public or team share of the All Documents View so people outside the workspace can browse the library without edit access.