Skip to content

Co-authoring Workflow

Intent

Enable concurrent edits with clear ownership and review

Behavior

Review Flow

The co-authoring workflow uses CODEOWNERS to route reviews to domain experts.

Co-authoring workflow with CODEOWNERS and required reviews

Implementation Considerations

CODEOWNERS & PR templates

  • Define code ownership per folder (profiles, terminology, examples)
  • Require 2 approvals incl. owner; enforce status checks

Editor config

  • .editorconfig for whitespace
  • Pre-commit hooks for FSH linting and JSON formatting

Benefits

  • Fewer merge conflicts

Trade-offs

  • Process overhead