Problem
docs/CONTRIBUTING.md documents this Spec format:
---
goal: <link to Goal issue>
---
# Feature Name
## Overview
What this Goal enables for users.
But the format already used across multiple repos is different — Objective, Key Results, Users, and Core Concepts (with user-facing methods per concept):
Contributors writing a new spec can't tell which format is actually expected.
Solution
Update the Format section of docs/CONTRIBUTING.md to document the Objective / Key Results / Users / Core Concepts structure, with a short example, so the docs match the norm already in use.
Problem
docs/CONTRIBUTING.md documents this Spec format:
But the format already used across multiple repos is different — Objective, Key Results, Users, and Core Concepts (with user-facing methods per concept):
Contributors writing a new spec can't tell which format is actually expected.
Solution
Update the Format section of docs/CONTRIBUTING.md to document the Objective / Key Results / Users / Core Concepts structure, with a short example, so the docs match the norm already in use.