public_git
/
freenas-proxmox
mirror of https://github.com/TheGrandWazoo/freenas-proxmox.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
freenas-proxmox/.claude/cos/adrs
History
Kevin Adams 4056e23267 docs: accept ADR-009, mark ADR-008 superseded 
ADR-009 (PVE version support v3.x + v4.0 strategy) accepted.
ADR-008 marked Superseded by ADR-009.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 		2026-05-31 23:17:23 -04:00
..
ADR-001-consolidate-build-into-main-repo.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-002-ui-strategy.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-003-apt-repo-hosting.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-004-cleanup-on-failure.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-005-bearer-token-authentication.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-006-versioning-strategy.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-007-freenas-vs-truenas-naming.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00
ADR-008-pve-version-support-matrix.md docs: accept ADR-009, mark ADR-008 superseded 2026-05-31 23:17:23 -04:00
ADR-009-pve-version-support-v3.md docs: accept ADR-009, mark ADR-008 superseded 2026-05-31 23:17:23 -04:00
README.md docs: finalize ADR statuses to Accepted; add ADR README and KSA scaffold 2026-05-19 11:07:49 -04:00

README.md

Architecture Decision Records

ADRs document significant decisions made about this project. They follow an RFC-style lifecycle.

Lifecycle

Status Meaning
Draft Being written or discussed. Not yet binding. May change freely.
Accepted Agreed upon and in effect. Guides implementation.
Superseded Replaced by a newer ADR. The old record is preserved as history. The header notes which ADR supersedes it.
Rejected Proposed but explicitly decided against. Preserved so we remember why.
Deprecated Was accepted but no longer applicable (e.g., a feature was dropped). Not replaced.

Rules

  • Never edit the Decision section of an Accepted ADR. If the decision changes, write a new ADR and mark the old one Superseded by ADR-XXX.
  • Draft ADRs can be edited freely — they are working documents.
  • Numbering is sequential and permanent. A superseded ADR keeps its number; the new one gets the next number.
  • Context and Consequences sections may be lightly edited for clarity even after acceptance (fix typos, add links), but the decision itself is immutable.

Index

ADR Title Status
ADR-001 Consolidate Build Pipeline into Main Repo Accepted
ADR-002 UI Integration Strategy Accepted
ADR-003 APT Repository Hosting Accepted
ADR-004 Transactional Cleanup on API Operation Failure Accepted
ADR-005 Bearer Token Authentication as Primary Auth Method Accepted
ADR-006 Package Versioning Strategy Accepted
ADR-007 FreeNAS vs TrueNAS Module Naming Accepted