docs: lead the generative AI disclosure with human design authority - #189
Merged
Conversation
Reorder the disclosure in paper.md, README.md, and philanthropy/__init__.py so it opens with what the author decided and reviewed, then states the scope of the AI assistance within those constraints. The facts are unchanged. The scope is still package-wide, no numeric split between authored and AI-assisted output is estimated, and the disclosure still rests on the review gate rather than on a percentage. Only the order and the emphasis moved, which keeps the paper's required AI usage disclosure section consistent with README.md, AGENTS.md, and the public commit history.
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
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.
What
Reorders the generative AI disclosure in
paper.md,README.md, andphilanthropy/__init__.pyso each one opens with what the author decided andreviewed, then states the scope of the AI assistance within those constraints.
Why
JOSS requires the AI usage disclosure as a named section, and the January 2026
policy is explicit that a pro forma disclosure is a problem. The previous
ordering led with the tool and reached the human review gate last, which reads
as a tool-first disclosure even though the substance was already there.
The facts are unchanged in all three places:
the author has not measured one;
suite against both coverage floors, the OS and Python matrix, the
dependency-floor install, the packaging check, the conformance battery),
not on a percentage.
Only the order and the emphasis moved, which keeps
paper.mdconsistent withREADME.md,AGENTS.md, and the public commit history.Verification
make ci: 1977 passed, 4 skipped, total coverage 97.77% against the 92.0% floor. Exit 0.make riskcov: risk-tier TOTAL 97%. Exit 0.draft-pdfwill re-renderpaper.mdon this PR; the paper stays within the1,750-word ceiling (no words added on net).
Credit
CHANGELOG.mdentry added under## [Unreleased] / ### Changed; author alreadylisted in
CONTRIBUTORS.md.