Skip to content

Document how list/hierarchical relevance departs from the proposal - #34

Merged
handrews merged 1 commit into
mainfrom
output-docs-relevance
Sep 25, 2026
Merged

handrews merged 1 commit into
mainfrom
output-docs-relevance

Conversation

@handrews

Copy link
Copy Markdown
Owner

The machines-oriented proposal has no concept of relevance, includes every unit in hierarchical, and makes pruning opt-in. The engine's default relevant level omits irrelevant records and prunes empty units; the guide now says so and names verbose=True as the unpruned structure.

Also correct the claim that a verbose node's own valid marks relevance: a result is relevant only when every node from the root down to it shares the root's valid. In list/hierarchical the dropped* markers classify records, and a unit's valid does not mark relevance even along its path. Tests pin both rules.

The machines-oriented proposal has no concept of relevance, includes every
unit in hierarchical, and makes pruning opt-in. The engine's default
relevant level omits irrelevant records and prunes empty units; the guide
now says so and names verbose=True as the unpruned structure.

Also correct the claim that a verbose node's own valid marks relevance: a
result is relevant only when every node from the root down to it shares
the root's valid. In list/hierarchical the dropped* markers classify
records, and a unit's valid does not mark relevance even along its path.
Tests pin both rules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@handrews
handrews merged commit 2482d04 into main Sep 25, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant