summaryrefslogtreecommitdiffhomepage
path: root/ssp-format-specification.md
diff options
context:
space:
mode:
authorRalph Amissah <ralph.amissah@gmail.com>2026-10-13 16:54:02 -0400
committerRalph Amissah <ralph.amissah@gmail.com>2026-10-13 16:54:02 -0400
commitbb28568715e9feabfd7ee357d4802dd0d251bbac (patch)
treefb3395673a2351462189674047e058e44bedd4d3 /ssp-format-specification.md
parentformat 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.md17
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