Skip to content
Documentation

ADR-032: Legal Output & PDF Workflow

FieldValue
TypeSkill Resource
Source~/.copilot/skills/adr/references/adr-032-legal-output-and-pdf-workflow.md
DescriptionNot specified

Source Content

ADR-032: Legal Output & PDF Workflow

Decision

Separate blank reusable source PDFs (assets) from completed filled examples (documentation artifacts), so an official blank template can be updated without touching documentation and completed examples can be versioned independently. Every template ships a three-part contract — blank asset, template story, completed output — plus a required field map table.

Key rules

  • Store the blank PDF template at src/components/patterns/forms/assets/<form-name>.pdf.
  • Publish a template Storybook story at Templates/Forms/<FormName> that shows the blank form with field annotations.
  • Store completed outputs at docs/design-system/forms/completed/<form-name>-completed.mdx, showing a filled example.
  • Give every template a field map table with columns: field name, field ID, type, and validation rules.
  • Never store completed outputs alongside blank templates — completed outputs are documentation artifacts, not source files.

Why

Splitting the official blank source from its filled examples lets each evolve on its own cadence: a form’s template can be revised without disturbing documentation, and completed examples can be versioned independently. The field map table makes field IDs and validation rules reviewable before a form ships. No external standard is cited because this is an internal asset-versus-artifact workflow decision. The completed-output path is expressed as .mdx to align with current dmwd-io docs-in-docs/ and MDX conventions (ADR-020).

Applies when

You are adding a new PDF form template, documenting a completed form example, or reviewing where a blank template versus a filled output should live.

  • ADR-012 — input & control sizing.
  • ADR-020 — docs folder convention and information architecture.
  • ADR-007 — print discipline (completed legal outputs must survive @media print).