MSP-1 schema

revisionNotes

Provides human-readable explanation of what changed in a revision, why the change was made, and any relevant context needed to interpret the change.

MSP-1 v1.0.1 Last updated 2026-06-29

revisionNotes schema definition

Machine-readable structure for declaring revision explanation metadata using either a lean string form or a structured object form.

Schema notes

MSP-1 v1.0.1 allows revisionNotes as either a string or a structured object. The string form is preferred when revisionNotes appears as a simple field inside a revision object.

For structured note metadata, notes is required. revisionNotes explains change context, but it should not be treated as proof of correctness, reliability, or trust by itself.