Process Handbook¶
This section documents how BFDev work moves from discovery through release.
Use process/ for the handbook itself:
- workflow overviews, companion guides, and supporting notes
- authoring guides
- publishing and release process notes
- reusable templates
Use artifacts/ for the actual challenge, specification, story, and delivery artifact sets produced by that process.
Start Here¶
Read these in order for governed engineering work:
- Product Engineering Workflow
- Product Engineering Delivery
- Product Engineering Workflow in Linear if the work is mirrored there
- Active Artifacts for the live challenge, specification, and story set you are working from
- System Design only when the current story depends on longer-lived design context
Use In-App Docs Authoring when the delivered work changes user-facing help or guidance. Use Release Notes when the delivered work changes what should appear in release communication or when a weekly published note is being prepared. Use GitLab Feature Flags for BetterFleet Manage feature-flag rollout, stage language, release-note handling, and retirement expectations.
Section Map¶
| Section | Purpose |
|---|---|
workflows/ |
Governed process flows, machine-readable policies, and supporting explainers |
guides/ |
Authoring and operating guidance for recurring documentation and delivery tasks |
templates/ |
Reusable starting points for future process artifacts |
publishing/ |
Internal notes and mechanics for later publication pipelines |