<feed xmlns='http://www.w3.org/2005/Atom'>
<title>sisudoc-abstraction-format/README.md, branch claude</title>
<subtitle>SiSU Spine: specs</subtitle>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/'/>
<entry>
<title>examples: real spine output in place of the hand-written ones</title>
<updated>2026-08-27T18:01:16+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-08-27T18:00:51+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=047ec2a6f7eecae8f08f1ea609c3f25aa13966aa'/>
<id>047ec2a6f7eecae8f08f1ea609c3f25aa13966aa</id>
<content type='text'>
Both example files said so in their own headers: "Hand-crafted
example showing what the serialized abstraction would look like",
with illustrative OCNs. They predated several format changes and
neither showed an object embedding an image.

example-autonomous-contract.ssp is now spine's output for that
sample document, complete and unedited but for the comment lines
naming the command that regenerates it.

example-wealth-of-networks.ssp is an excerpt of spine's output for
that document, the whole being some 19,500 lines: verbatim lines
with marked elisions, keeping the @meta / @make / @doc_has
preamble, the @head section, and body objects [95] to [99], among
them [97], which embeds an image and so carries an .image record.

Both parse: ssp-reader --tree and --images read them, the latter
reporting the image record of [97] against the digest the pod's
digests.txt gives for won_benkler_2_1.png.

README: the two files described separately (complete / excerpt),
and the quickstart names the flags that actually write a .ssp.

Carries with it the git.sisudoc.org namespace corrections to the
README links that were already staged in the working tree.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Both example files said so in their own headers: "Hand-crafted
example showing what the serialized abstraction would look like",
with illustrative OCNs. They predated several format changes and
neither showed an object embedding an image.

example-autonomous-contract.ssp is now spine's output for that
sample document, complete and unedited but for the comment lines
naming the command that regenerates it.

example-wealth-of-networks.ssp is an excerpt of spine's output for
that document, the whole being some 19,500 lines: verbatim lines
with marked elisions, keeping the @meta / @make / @doc_has
preamble, the @head section, and body objects [95] to [99], among
them [97], which embeds an image and so carries an .image record.

Both parse: ssp-reader --tree and --images read them, the latter
reporting the image record of [97] against the digest the pod's
digests.txt gives for won_benkler_2_1.png.

README: the two files described separately (complete / excerpt),
and the quickstart names the flags that actually write a .ssp.

Carries with it the git.sisudoc.org namespace corrections to the
README links that were already staged in the working tree.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: add README under git.sisudoc.org/tools/ namespace</title>
<updated>2026-05-12T00:41:31+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-05-12T00:41:31+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=c17ca174c4aca4ed6cf47682f5f49389502b8ae5'/>
<id>c17ca174c4aca4ed6cf47682f5f49389502b8ae5</id>
<content type='text'>
Add a top-level README.md identifying the repository as a
specification (not a program), summarising what .ssp is (a
human-readable, PEG-parsable serialisation of spine's in-memory
document abstraction), listing the line-type grammar at a glance,
and pointing readers at format-specification.md for the full
reference and at the two example .ssp files shipped alongside.

Canonical URLs use the new git.sisudoc.org/tools/ namespace,
matching the parallel moves in tree-sitter-sisu and ssp-reader
and the local rename of sisudoc-spine-utils/ to
sisudoc-spine-tools/. Cross-references to ssp-reader and
tree-sitter-sisu follow the same convention.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Add a top-level README.md identifying the repository as a
specification (not a program), summarising what .ssp is (a
human-readable, PEG-parsable serialisation of spine's in-memory
document abstraction), listing the line-type grammar at a glance,
and pointing readers at format-specification.md for the full
reference and at the two example .ssp files shipped alongside.

Canonical URLs use the new git.sisudoc.org/tools/ namespace,
matching the parallel moves in tree-sitter-sisu and ssp-reader
and the local rename of sisudoc-spine-utils/ to
sisudoc-spine-tools/. Cross-references to ssp-reader and
tree-sitter-sisu follow the same convention.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
</feed>
