Skip to content

docs: README, DocC catalogues, licence texts and CITATION for 0.11.0 - #26

Merged
Paullo9 merged 1 commit into
mainfrom
docs/14-readme-docc
Oct 28, 2026
Merged

Paullo9 merged 1 commit into
mainfrom
docs/14-readme-docc

Conversation

@Paullo9

@Paullo9 Paullo9 commented Oct 28, 2026

Copy link
Copy Markdown
Contributor

Requested by Paul · project thread

Refs #14 (the parts the 28 Oct triage cleared to go first; the issue stays open for the rest).

What changed

  • README: install line is .package(url: "https://github.com/mac4DSTEM/FormatoKit.git", from: "0.11.0"); "readers and writers" (writers ship); CI, Docs, release and licence badges plus the DocC site link; one sentence that the shipped binaries are arm64 only; the "design note archived in the suite's private folder" remark is gone; names.sh is no longer in the build list.
  • DocC: FormatoMRC.docc said "no public API yet"; it now documents MRCReader, MRCAppImage, MRCError, and its Scope article says what is read and pinned. New catalogues for Formato, FormatoPeek and FormatoMIB, so every product has one. MRCReader gets the doc comment it lacked. .spi.yml lists all eleven modules (MSA is no longer called an empty placeholder).
  • Licenses/: adds tifffile-LICENSE.txt (tifffile v2026.9.20) and Pint-LICENSE.txt (Pint 0.26.1), verbatim from the upstream tags; NOTICE points at them and loses its private-folder sentence.
  • CITATION.cff: version: "0.11.0", date-released: "2026-10-22", the ORCID TODO removed.

Waiting, per the triage comment

  • CHANGELOG in Keep a Changelog form: release-please will write its own format.
  • One SPDX id everywhere: waits for the GPL-3.0 vs "or later" decision. README, CITATION and NOTICE are unchanged on that point.
  • CITATION version is updated by hand at each tag until release-please can bump it.

The docs workflow runs on this PR, since it touches .docc files, and builds the three new catalogues. Written on Linux, so macOS CI is the build check.


Generated by Claude Code

README: install line at 0.11.0 with the repository URL, readers and
writers (writers ship), CI/docs/release/licence badges and the docs
link, one sentence that the shipped binaries are arm64 only, no
private design-note remark, no names.sh in the build list.

DocC: FormatoMRC's catalogue described a module with no API; it now
documents MRCReader, MRCAppImage and MRCError. New catalogues for
Formato, FormatoPeek and FormatoMIB, so every product has one;
.spi.yml lists all eleven.

Licenses/ gains the tifffile 2026.9.20 and Pint 0.26.1 BSD-3-Clause
texts, both ported from; NOTICE points at them.

CITATION.cff gains version and date-released and loses the ORCID TODO.

The CHANGELOG format and the single SPDX id wait for the release-please
and licence decisions (triage 28 Oct).

Refs #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VkKZEVqoFybEsYt19gka8C
@Paullo9 Paullo9 self-assigned this Oct 28, 2026
@Paullo9
Paullo9 merged commit 470f96d into main Oct 28, 2026
7 checks passed
@Paullo9
Paullo9 deleted the docs/14-readme-docc branch October 28, 2026 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants