feat(standard): require root LICENSE symlink into LICENSES/ — v1.36 - #15
Conversation
§4.3: the root LICENSE file is now required and MUST be a symbolic link to the project's primary license text in LICENSES/, upgrading the former "MAY remain as a GitHub-detection pointer" allowance. GitHub follows the symlink for license detection while REUSE keeps the verbatim texts in LICENSES/ — one source of truth, no drift between duplicated copies. Link target follows the §4.1.1 artifact class. §5.2: LICENSE added as a required posture file in its own right. §16: compliance-checklist §4.3 bullet extended with the requirement. Self-applies: this repo is document-primary, so its new root LICENSE symlinks to LICENSES/CC-BY-SA-4.0.txt. Verified locally: makeinfo --no-split → zero errors/warnings; reuse lint → compliant; .md companion regenerated. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 441bb5ca50
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| for license detection, and `reuse lint` stays clean. The link target | ||
| is the repository’s **primary** license per §4.1.1 — | ||
| `GPL-3.0-or-later` (or `AGPL-3.0-or-later` when network-facing) for a | ||
| software-primary repo, `CC-BY-SA-4.0` for a document-primary repo. A |
There was a problem hiding this comment.
Allow CC-BY-4.0 as a document repository's target
For a document-primary repository exercising §4.1.1's explicitly permitted CC-BY-4.0 option, this mandates linking LICENSE to CC-BY-SA-4.0 instead. That either misrepresents the repository's actual license or makes compliance with both requirements impossible; the target should follow the document license actually selected, including CC-BY-4.0.
Useful? React with 👍 / 👎.
…1.36 (#15) Back-sync of Spacecraft-Software/Standard#15. §4.3: the root LICENSE file is now required and MUST be a symbolic link to the project's primary license text in LICENSES/, upgrading the former "MAY remain as a GitHub-detection pointer" allowance. GitHub follows the symlink for license detection while REUSE keeps the verbatim texts in LICENSES/ — one source of truth, no drift. §5.2: LICENSE added as a required posture file in its own right. §16: compliance-checklist §4.3 bullet extended with the requirement. Masthead and frontmatter description bumped to v1.36 (2026-07-26); description measures 924 chars, under the 1000-char skill limit. Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
What
§4.3 — the root
LICENSEfile is now required and MUST be a symbolic link to the project's primary license text inLICENSES/:This upgrades the former "a root
LICENSEMAY remain as a GitHub-detection pointer" allowance. GitHub follows the symlink for license detection; REUSE keeps the verbatim texts underLICENSES/. One source of truth, no drift. A duplicated regular-fileLICENSEis explicitly non-compliant. Link target follows the §4.1.1 artifact class —GPL-3.0-or-later/AGPL-3.0-or-laterfor software-primary repos,CC-BY-SA-4.0for document-primary repos.§5.2 —
LICENSEadded as a required posture file in its own right (previously only mentioned inside theLICENSES/row).§16 — compliance-checklist §4.3 bullet extended with the symlink requirement.
Self-applies
This repo is document-primary, so its new root
LICENSEsymlinks toLICENSES/CC-BY-SA-4.0.txt(mode120000).Verification
makeinfo --no-split The_Steelbore_Standard.texi→ zero errors, zero warningsreuse lint→ compliant with REUSE 3.3.mdcompanion regenerated via the DocBook → pandoc route@settitle,@set VERSION,@set UPDATED) + changelog entryFollow-up
Construct back-sync (
spacecraft-standard-constitution/SKILL.md+references/CHANGELOG.mdat v1.36) lands as its own PR.🤖 Generated with Claude Code