DocumentationDecisionsDecision Lifecycle

Decision Lifecycle

Every decision moves through defined statuses. Status controls visibility, editing, and who may transition next.

Statuses

StatusMeaning
DraftWork in progress; not yet submitted for team review
ProposedPublished; awaiting discussion and management approval
ApprovedAccepted; ready for implementation
RejectedDeclined; will not be implemented as proposed
ImplementedWork completed; historical record

Transitions

Draft → Proposed (Publish)

Who: decision author with Page Write, or Manage Team, or Owner
How: Publish Decision on create/edit form, or Publish in Management sidebar on detail view

Sets finalized metadata (who/when).

Proposed → Approved / Rejected

Who: Manage Team or Owner
How: Approve or Reject buttons in Management panel

Records approver/rejector and timestamp.

Approved → Implemented

Who: an assignee OR Manage Team / Owner
How: Mark Implemented

Only from Approved status.

Any published status → Draft (Reset)

Who: Manage Team or Owner
How: Return to Draft — confirmation warns that timeline milestones reset

Clears approval/rejection/implementation timestamps.

Content freeze

Once status is not Draft, regular authors cannot edit title, description, reasoning, tags, assignees, or attachments. Managers follow the same freeze except for allowed status transitions.

This preserves audit integrity after publication.

Timeline UI

The decision detail sidebar shows a stepper:

Posted → Finalized → Approved/Rejected → Implemented

Each step shows Pending… until completed, with by {user} attribution when available.

Filtering

The page list supports multi-select filters for all five statuses to build custom views (e.g. only Proposed + Approved).