Operations Intermediate 1 minute read Updated 2026-06-26 UTC

Versioned source editions

How to preserve new uploaded report editions under `/docs` while keeping curated operating truth clean and current.

Research statusOperational guidance Publication statePublished Reviewed byMichael Kappel Source reports3

Source preservation rule

When a new report edition arrives, preserve it under /docs and add a manifest record. Do not silently replace older editions. Duplicate hashes are acceptable because filenames, upload context, and release history are part of provenance.

Curated pages should cite the newest useful edition when it adds new material, but raw reports remain evidence until promoted.

Edition workflow

StepAction
IntakeCopy uploaded Markdown to /docs.
HashRecord size and SHA-256.
ManifestAdd unique slug and summary.
SynthesisPromote relevant positive claims into pages or .uai.
ReleaseNote additions in CHANGELOG and UAI ledger.
pseudocode
FUNCTION add_source_edition(file)
    copy_to_docs(file)
    metadata = compute_size_and_sha256(file)
    manifest_slug = create_unique_report_slug(file.name)
    append_manifest(manifest_slug, metadata)
    update_docs_source_ledger()
    RETURN manifest_slug
END FUNCTION

Positive outcome

The project gains memory without confusion. Source history remains complete, and the current site remains curated.

Source reports used for this guide

These reports are preserved verbatim in the site archive. The guide above is an editorial synthesis and may narrow, qualify, or reorganize claims from the source material.