Repository navigation
A convention put to the maintainer comes with what the references say - #2159
Merged
Rafael-SOWNet merged 1 commit intoOct 27, 2026
Merged
Conversation
AGENTS.md already asks for every convention to be checked against a second and third source, Wolfram MathWorld and Wikipedia among them, before it is adopted. It did not say the same of a question: on #2131 the notation choices a geometry book raises were put to the maintainer as bare alternatives, and he asked for Wikipedia and MathWorld to be consulted first. Read, they settled most of them: (a, b) as the pair, dot and cross as a . b and a x b, the plane's pseudo-scalar product as MathWorld's perp dot product, and the Kronecker delta as an Iverson bracket. The section now says that a question about a notation, a name, a convention or a definition carries what those sources say, quoted and linked, and a recommendation. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012sonx8iAspMiwRwokT1Ura
Rafael-SOWNet
deleted the
a-convention-is-looked-up-before-it-is-asked
branch
October 27, 2026 10:40
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.
Asked for on #2131 ("You should consult additional sources like Wikipedia and Wolfram MathWorld etc for how to approach these mathematical decisions, before presenting the decision. Do you need to write these into your instructions?").
AGENTS.mdalready says to check a convention against MathWorld and Wikipedia before adopting it, in A reference is read for everything it says. It did not say the same of a question to the maintainer, and that is where I went wrong on #2131: I put the notation choices to him without having read either source. Read, they settled most of the choices.The added paragraph: a question about a notation, a name, a convention or a definition comes with what those sources say, quoted and linked, and a recommendation. Bare alternatives are reading left undone.
Documentation only; nothing reads this text at run time.
🤖 Generated with Claude Code
https://claude.ai/code/session_012sonx8iAspMiwRwokT1Ura