The O&M manual is the deliverable everyone agrees matters and nobody wants to build. It comes due at the worst moment of the job, when the crew is commissioning, the punch list is growing, and the last thing anyone wants is a document project. So it gets built badly, late, out of whatever PDFs are lying around, and the operator who inherits it can't find the part number for a failed relay without paging through 400 sheets.
It doesn't have to go that way. The manual is an assembly job, and almost everything in it already exists by the time it's due. The trick is structure decided early and collection done continuously.
Who the manual is for
Not the reviewing engineer. The manual's real readers are the operator responding to an alarm and the maintenance tech replacing a failed component, possibly a decade from now, possibly with nobody from the original project reachable. Every structural decision should favor that reader: organize by the physical thing they're standing in front of, not by the spec section the paperwork answered.
The structure
For a system with multiple sites or panels, give each panel its own chapter with the same internal order. Repetition is a feature; the tech who learns the layout for one panel knows it for all of them.
Front matter
Cover with the project name, site, your company, and the date. A clickable table of contents. A revision block if the manual will be re-issued.
1. System overview and safety
One or two pages: what the system does, in plain words, plus the safety information the spec requires. Arc flash labels, lockout points, hazards specific to this installation. Short is fine. Nobody reads a 30-page overview.
2. Panel bill of materials
The heart of the manual: one table per panel listing every component inside it. Tag, description, manufacturer, catalog number. When something fails, this table is what turns "the little relay on the left" into an orderable part number. If you keep an equipment register during the job, this table is an export, not a writing task.
3. Panel drawings
As-built, not as-designed. The drawings in the manual must show the panel as it actually shipped, with every field change incorporated. A manual carrying superseded drawings is worse than no manual; it tells the tech to look for wires that aren't there. If your as-builts run through a redline process, this is where those redlines land. What a complete drawing set includes is its own topic: see what a complete panel drawing package includes.
4. Component datasheets
The cut sheet for every catalog number in the BOM, included once each, with the supplied part number marked the same way you marked the submittal. The manual reuses the submittal's datasheets almost verbatim, which is exactly why maintaining one document library all job long pays off twice; see building a reusable parts library.
5. Manufacturer O&M literature
Different from datasheets: these are the installation, operation, and maintenance instructions for the major equipment. VFD manuals, PLC hardware manuals, instrument calibration procedures. The spec usually names what's required. Include what the maintenance tech needs, not the manufacturer's entire literature shelf.
6. Configured sections the spec demands
Read the spec's closeout and O&M articles early and list what they require beyond the above. Common ones: commissioning and test records, calibration sheets, an arc flash study, spare parts lists, warranty statements, training documentation. Every job differs here, which is why the manual needs a per-project recipe rather than a copied template that quietly omits something this contract requires.
The process that makes it painless
Decide the structure at kickoff, not at closeout. Write the section list for this project in week one, when the spec's requirements are fresh from bid review. Now the manual is a container that fills up, instead of a blank page at the end.
Collect as you go. Every datasheet gathered for the submittal, every drawing revision, every test record: file it against the equipment it belongs to at the moment it exists. The last week of the job should be assembly and a completeness check, nothing more.
Keep one equipment list. The BOM table, the datasheet set, and the drawing references all hang off the same list of tags and catalog numbers. Maintain it in one place and every downstream document agrees; maintain three copies and they will disagree at exactly the moment someone relies on them.
Issue it like a submittal. Many specs require the O&M manual to be submitted for review before acceptance. Number it, log it, keep the issued copy frozen, and track the response like any other package. On projects that tie acceptance or payment to the manual, its review cycle is the one you can least afford to repeat. How manuals fit into the larger closeout picture is covered in the closeout checklist.
How Submittal Kit handles this
The last-week scramble happens because someone rebuilds the equipment list from memory. In Submittal Kit an O&M manual starts from the submittal you already issued: Create O&M Manual from this submittal links the two, and they share one equipment list live, so an approved substitution is already in the manual with nothing retyped. The manual is a submittal with a closeout recipe. The standard template opens with cover, transmittal, and table of contents, then equipment chapters that collect each item's datasheets and manuals, and it carries sections for warranties, testing and commissioning, and emergency contacts. A Station/Panel BOM section builds itself from the equipment at compile time. Add, reorder, or rename sections per project, compile to a bookmarked PDF, and issue it onto the log like any other package. See O&M manuals and Configure sections.
Disclosure: I build Submittal Kit, and the structure above is worth stealing whatever you assemble with.