Skip to content

Specification Notes

Notes enable implementation teams to capture information specific to a Specification. They can be added at the field level and provide valuable specification-level context that may not be represented within the standard specification definition.

Typical examples include:

  • Mapping and transformation decisions
  • Business rules and clarifications
  • Additional implementation guidance related to the specification

Write notes for your future self

Capture the why behind a decision, not just the what — it saves rediscovery time during later implementations.

Specification notes

Adding a field-level note to capture mapping and transformation context.