diff options
| author | Ralph Amissah <ralph.amissah@gmail.com> | 2026-10-13 16:54:02 -0400 |
|---|---|---|
| committer | Ralph Amissah <ralph.amissah@gmail.com> | 2026-10-13 16:54:02 -0400 |
| commit | bb28568715e9feabfd7ee357d4802dd0d251bbac (patch) | |
| tree | fb3395673a2351462189674047e058e44bedd4d3 /ssp-format-specification.md | |
| parent | format 2.1: on poems and editor's notes (diff) | |
2.1.1: the patch part of a release number; the readers namedclaude-spec-matchup
A release is numbered major.minor.patch. major.minor is the format,
and is shared by the specification and the programs that implement
it; the patch is each one's own. A patch changes nothing a file can
contain - a correction or clarification of this text, or a fix in a
program - so a file declares major.minor only, as it always has, and
spine and every reader are unaffected.
Section 2.1 of the .ssp specification says so, beside the rule for
the minor and major parts, and a new 2.3 lists the releases of this
text: 2.0.0 the model and the .ssp, 2.0.1 the kinds, types, levels,
make block and markers, 2.0.2 the .ocda.db and two rules a validator
found, 2.0.3 the derived values, 2.1.0 .ocn_range and the editor's
notes, 2.1.1 this. The README's version section says it in brief.
The README's related projects name the first readers,
sisudoc-ssp-reader and sisudoc-ocda-db-reader, published frozen as
the record of readers written from this specification alone, their
work now done by ocda-read in sisudoc-ocda-lib.
claude-org/: ocda_specification.org with the same changes, so that it
tangles every document exactly as committed, and the version and
header file with its two local git+file blocks taken out; proposed
replacements for their org/ counterparts.
(assisted by Claude-Code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'ssp-format-specification.md')
| -rw-r--r-- | ssp-format-specification.md | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/ssp-format-specification.md b/ssp-format-specification.md index a401947..6ac0030 100644 --- a/ssp-format-specification.md +++ b/ssp-format-specification.md @@ -77,6 +77,12 @@ row, so that one bump moves both. away**. - A reader **checks the major part and refuses what it does not know**, rather than loading an unfamiliar artefact half populated in silence. +- A **patch** part, the third, numbers *releases* and not the format: a + correction or clarification of this text, or a fix in a program that + implements it, changes nothing a file can contain. So a file declares + `major.minor` only, and a release is `major.minor.patch`. The + specification and the programs that implement it share `major.minor`, + which is the format, and each numbers its own patches. ### 2.2 History @@ -87,6 +93,17 @@ row, so that one bump moves both. | 1.1 | 2026-09-10 | The `@source` block; the document metadata the output writers read, carried in full (14 `@meta` and 3 `@make` properties added); `.segment_lv4_is`. | | 0.1 | | The first form. | +### 2.3 Releases of this specification + +| release | format | what | +|---------|--------|---------------------------------------------------------------------| +| 2.0.0 | 2.0 | the model and the `.ssp` | +| 2.0.1 | 2.0 | the object kinds and types, the levels, the make block, the markers | +| 2.0.2 | 2.0 | the `.ocda.db`; two rules a validator found unstated | +| 2.0.3 | 2.0 | the derived values: the identifier and the anchor | +| 2.1.0 | 2.1 | `.ocn_range`, and the editor's notes | +| 2.1.1 | 2.1 | the patch part of a release number, and this table | + ## 3. Lexical structure Six line types, distinguished by their first character. Nothing else is a |
