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 /README.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 'README.md')
| -rw-r--r-- | README.md | 9 |
1 files changed, 9 insertions, 0 deletions
@@ -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. |
