Skip to content

v1.3 — illustrated edition

Choose a tag to compare

@rdicosmo rdicosmo released this 07 Sep 20:18
· 4 commits to main since this release

⚠️ Superseded — use v1.4. Two rounds of correction apply to this release.

  • SWHID guidance (cookbook and handouts), corrected in v1.3.1: swh identify has no --permissions-source flag, and pointing it at a working copy hashes .git/, build output and editor droppings along with the artifact.
  • Appendix G, artifact evaluation, rebuilt in v1.4: this release tells authors not to archive before acceptance under double-blind review, and asks reviewers to recompute the identifier. Neither is necessary — a core SWHID discloses no origin, author or date, and the archive retrieves by hash, so a reviewer has nothing to check. See v1.4 §G.3 and §G.7.

Everything else in this release stands.


The illustrated edition. Every chapter now opens with a pen-and-ink plate of Archie, the elephant archivist, followed by a short summary of what the chapter argues; the title page carries a frontispiece — a tree growing out of an open book, its leaves made of files.

What changed

Illustrations. Nine chapter-head plates plus a frontispiece, at full measure. A provenance record — the mascot's design, every prompt, the failed iterations, and an AI-generation disclosure — is kept with the source images.

Refreshed evidence. Archive counters updated to the 2026-09-08 baseline (29.5 billion source files, 441 million projects). The graph figures are now cited: 58,675,740,295 nodes and 1,101,018,460,510 edges, from the publicly readable s3://softwareheritage/graph/2026-06-04/compressed. Figure 3.1's counters are typeset rather than shipped as unreadable pixels — the smallest text on that page goes from roughly 3 pt to 11 pt.

New Appendix G — a model artifact-evaluation section. Paste-ready text for programme chairs, an eight-step author walkthrough and a six-step reviewer procedure, a mapping onto the existing ACM badge vocabulary, and the questions a chair actually asks. Synthesised from 34 artifact-evaluation guidelines, written to be additive: it removes no DOI and displaces no deposit.

Typography. Key takeaways are now cut into the text block rather than parked in the margin; the accent colour is reserved for structure; the title page uses the book's display sans.

Archived source

swh:1:dir:a53cbfce5692dd6b375af39965089e3a4301905a;origin=https://github.com/rdicosmo/source-code-of-science;visit=swh:1:snp:b3e19812a3c2461aa3d5866ba49a1f24f1f4b765;anchor=swh:1:rev:d7263e66ea4d96ba28df3ef5af3700bc21327434

The archived directory was verified against a local git archive HEAD computation before this release was cut.