Skip to content

docs(language): only a dimension some declaration reaches needs a source - #378

Merged
FBumann merged 1 commit into
mainfrom
docs/dimension-source-reach
Sep 2, 2026
Merged

FBumann merged 1 commit into
mainfrom
docs/dimension-source-reach

Conversation

@FBumann

@FBumann FBumann commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Prompt: "#242: 'a dimension a declaration reaches and nothing supplies'." — from an lpspec review of the merged rule, measured against that corpus.

Note

The following content was generated by AI.

#242 landed the binding rules with one of them stated too strongly:

A dimension nothing supplies is an error naming it, not an empty axis

No qualifier. A declared dimension that no declaration reaches builds and solves in lpspec today — the reviewer probed one — and a dimension a declaration does span is refused there correctly. So the rule as written was stricter than either implementation of it, which is the worst way for a page like this to be wrong: it is the normative text, and a consumer written to it would refuse working models.

Now:

A dimension a declaration reaches and nothing supplies is an error naming it,
not an empty axis — an axis with no members would delete every row indexed by
it, silently. A declared dimension no declaration reaches asks nothing of the
data, and needs no source.

The second sentence is added rather than implied. The rule's whole point is that a consumer implements it instead of choosing, so the case it does not cover should not be left to be inferred from the absence of a clause.

Verified

pixi run lint and pixi run docs-build (mkdocs build --strict) pass in a clean worktree at base bbecc71.

Not run: test and compile-tex — the diff is one paragraph of prose in docs/, and no generated page reads it. tests/test_docs.py covers the generated pages, and this is not one.

Scope: the wording only. The other findings from the same review land on #245, which is where the coverage: guard they concern lives.


Generated by Claude Code

The rule as merged in #242 said a dimension nothing supplies is an error, with
no qualifier. A declared dimension no declaration reaches builds and solves in
lpspec today, so the rule was stricter than any implementation of it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013a3tFCULeY7Skmkhbxpj7V
@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 math-spec | 🛠️ Build #34349253 | 📁 Comparing 392c7f3 against latest (bbecc71)

  🔍 Preview build  

1 file changed
± reference/language/dimensions/index.html

@FBumann
FBumann merged commit b3b9549 into main Sep 2, 2026
5 checks passed
@FBumann
FBumann deleted the docs/dimension-source-reach branch September 9, 2026 06:45
@FBumann FBumann added the docs Documentation pages, guides, reference and README label Sep 24, 2026 — with Claude
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation pages, guides, reference and README

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant