docs(v1.100.3a): H-10 — fix broken HEADER_SPEC.md link#505
Merged
Conversation
Closes repo hygiene audit finding H-10: CONTRIBUTING.md:242 linked to [HEADER_SPEC.md] which does not exist at repo root. The header spec content already lives inline in CONTRIBUTING.md (section "File Headers" — SPDX line, meta:* tags, mandatory inventory keys). Changes: - CONTRIBUTING.md: drop broken self-link; add a sentence noting the inline section IS the authoritative spec and that CI enforces it via tools/validate-headers.sh. Section heading retitled from "HEADER_SPEC.md (File Headers)" to plain "File Headers". - tools/validate-headers.sh: error message no longer references the non-existent HEADER_SPEC.md. Pointer text now says "CONTRIBUTING.md, section 'File Headers' (authoritative spec)". Header comment updated to match. Smallest zero-risk slice. No behavior change. Reviewer surface = 5 lines of doc + comment-only edits. Out of scope (deferred to slice 1b): - H-01 / H-02 / H-03 — dev-path cleanup, separate micro-PR. Lifecycle completion lane (PR-25..PR-30) remains explicitly OPEN. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Repo hygiene Phase A — slice 1a. Smallest possible doc-only fix.
Closes audit finding H-10: `CONTRIBUTING.md:242` linked to `HEADER_SPEC.md` which does not exist at repo root. `tools/validate-headers.sh` also referenced the missing file in its error message.
Why this is the smallest possible slice
The header-spec content already lives inline in `CONTRIBUTING.md` (section "File Headers" — SPDX-License-Identifier, all `meta:` tags with quoted values, all mandatory inventory keys). The broken link was a "see also" pointer to a phantom file. No new spec authoring is needed — just remove the broken pointer and clarify that the inline section is itself the authoritative spec.
Changes
3 files changed, 23 insertions(+), 5 deletions(-) — most of the diff is the CHANGELOG entry.
Out of scope (deferred to slice 1b)
Lifecycle completion lane (PR-25..PR-30) remains explicitly OPEN.
Test plan
🤖 Generated with Claude Code