Skip to content

v1.6 — citing these notes, and naming their own sources

Latest

Choose a tag to compare

@rdicosmo rdicosmo released this 24 Sep 12:01

Two new appendices, and three values the build now derives instead of being told.

Appendix I, How to cite these notes. Cite the HAL record without a version
number, https://hal.science/hal-05734828, which always resolves to the latest
version; cite the versioned record, the release tag or the source SWHID when the
reference supports a claim. Includes the plain-text and BibTeX forms, and the
reason the HAL PDF and the release PDF are different digital objects.

Appendix J, How these notes name their own sources. An intrinsic identifier
is a hash of content, so a file cannot name itself. It can name the sources it
was built from, provided the stamp is derived rather than declared and kept out
of the tree it names. The appendix explains the mechanism and invites the reader
to recompute it with make swhid.

Derived, not declared. The version now comes from the annotated tag via
git describe, so the tag is the single source of truth. The date comes from the
commit rather than the clock, so two people building this revision get the same
title page. The source SWHID is computed offline from git archive HEAD into the
git-ignored swhid.tex. The build stamps a clean tree only.

Title page gains the affiliations, homepage and ORCID.

Source tree of this release:

swh:1:dir:8245d19766173d59c2847826ade1128f4f4fd8b1;
  origin=https://github.com/rdicosmo/source-code-of-science;
  visit=swh:1:snp:59e699dda0e3844b41090096f0a04a9e02b2f2da;
  anchor=swh:1:rel:c15603ebc97f8580a9b4bcf27f9fcb02f3be8b7b