summaryrefslogtreecommitdiffhomepage
path: root/README.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 /README.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 'README.md')
-rw-r--r--README.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/README.md b/README.md
index 400bced..2054386 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,11 @@ when one changes meaning or goes away, and a reader checks the major
part and refuses what it does not know. The history is in the
specification.
+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, and changes nothing a file can contain, so it is not
+written in a file.
+
## What is `.ssp`?
Spine's processing pipeline goes
@@ -141,5 +146,9 @@ project.
- [sisudoc-ocda-writer](https://git.sisudoc.org/sisudoc-ocda-writer) -
sample writers over that library (text, markdown, html, epub, typst),
each checked against spine. To be published.
+- [sisudoc-ssp-reader](https://git.sisudoc.org/sisudoc-ssp-reader) and
+ [sisudoc-ocda-db-reader](https://git.sisudoc.org/sisudoc-ocda-db-reader) -
+ the first readers, written from this specification alone, in D and in
+ Gleam; frozen, their work now done by `ocda-read` in sisudoc-ocda-lib.
- [tree-sitter-sisu](https://git.sisudoc.org/tree-sitter-sisu) - grammar
for the .sst / .ssm markup spine reads before writing a .ssp.