Establishes the pattern for distributing optional packages (starting with
truenas-proxmox-multipath) via apt components within existing dist tracks.
Users add 'multipath' to their sources.list component list to opt in;
standard users are never affected by apt upgrade.
References: #256 (multipath), #272 (testing track)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.
95b71e9c7d