Skip to content

ADR-0005: Forgejo Actions builds documentation

  • Status: Accepted
  • Date: 2026-07-02
  • Supersedes: Drone direct publication

Context and decision

Administrators should not need local MkDocs to publish. Forgejo Actions uses a containerized, pinned build, runs strict validation, and writes the generated site through an allowed runner-data mount.

Alternatives

Local builds, Drone SSH copy to CT 103, and committing site/ were rejected because they create workstation or mutable-output dependencies.

Consequences

Publication depends on the runner label, job DNS, valid bind allow-list, and the main push condition. Local builds remain optional validation only.

Validation evidence

Workflow source and live runner configuration were compared on 2026-07-17.