Skip to content

Commit

Permalink
TEMPLATE.md: Distinguish between alignment on syntax and alignment on…
Browse files Browse the repository at this point in the history
… goal
  • Loading branch information
joshtriplett committed Dec 18, 2024
1 parent 49399b9 commit fa1c5ec
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions src/TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,8 @@

*This text is NORMATIVE, in the sense that teams should review this and make sure they are aligned. If not, then the shiny future should be moved to frequently asked questions with a title like "what might we do next".*

*However, for most proposals, alignment on exact syntax should not be required to start a goal, only alignment on the problem and the general sketch of the solution. This may vary for goals that are specifically about syntax, such as ergonomic improvements.*

## Design axioms

*This section is optional, but including [design axioms][da] can help you signal how you intend to balance constraints and tradeoffs (e.g., "prefer ease of use over performance" or vice versa). Teams should review the axioms and make sure they agree. [Read more about design axioms][da].*
Expand Down

0 comments on commit fa1c5ec

Please sign in to comment.