Link-Katalog: authored/alternative-to/addresses, entity→entity-Lineage, Lint-Befund redundant_see_also (4.7.0, #43 #49)
Files changed: - CHANGES.md - VERSION - instructions/link-taxonomy.md - kb/concepts/COLLECTION.md - kb/entities/COLLECTION.md - kb/entities/people/Andrej Karpathy.md - kb/entities/people/Vannevar Bush.md - tools/chemenu/evals/scorecard.py - tools/chemenu/links.py - tools/chemenu/lint_core.py - tools/chemenu/tests/test_lint.py
This commit is contained in:
@@ -44,6 +44,16 @@ That is why most labels below have no inverse. Only three pairs do, because in e
|
||||
direction is a genuine primary statement someone would write on its own: `depends-on` /
|
||||
`required-by`, `runs-on` / `hosts`, and `composition` / `part-of`.
|
||||
|
||||
**A self-dual label is still written once.** `alternative-to` is its own inverse - the sentence
|
||||
reads identically from either end - and that makes it the easiest label in the catalogue to
|
||||
write twice by reflex. Symmetry means the relation holds in both directions, not that both pages
|
||||
must declare it: one edge per pair, and the other page's inbound view carries it. The difference
|
||||
is not cosmetic at scale. Seven mutually substitutable tools are 21 pairs; declared once each
|
||||
that is 21 edges, declared from both ends it is 42, and the second 21 say nothing the first did
|
||||
not. This is the shape a `see-also` clique already had in this corpus before the labels existed,
|
||||
and relabelling such a clique without dropping to one edge per pair moves the problem rather
|
||||
than fixing it.
|
||||
|
||||
The third was added after the 4.0.0 migration, from measurement rather than from the desk. A
|
||||
parent-child structure - a tier list and its tiers, a spectrum and its levels - produces the
|
||||
question on nearly every page: the parent writes `composition`, and the child then reaches for
|
||||
@@ -100,10 +110,23 @@ entity to entity.
|
||||
| `consumes` | — | reads the target as an artifact or data |
|
||||
| `maintains` | — | carries the upkeep of the target |
|
||||
| `owns` | — | is accountable for the target's existence and decisions |
|
||||
| `authored` | — | created the target as a one-time act |
|
||||
| `alternative-to` | itself | serves the same purpose as the target, so a reader choosing between them wants both |
|
||||
|
||||
`uses` versus `depends-on` is the distinction worth keeping sharp: if removing the target breaks
|
||||
this thing, it is `depends-on`. `owns` versus `maintains`: accountability versus labour, and
|
||||
they are often different people.
|
||||
this thing, it is `depends-on`.
|
||||
|
||||
`authored`, `owns` and `maintains` are three different sentences about the same pair, and often
|
||||
three different people: origination, accountability, labour. `owns` is a *standing* claim - it
|
||||
says someone answers for this thing now - so it reads false about a person who is dead or long
|
||||
gone from the project, however plainly they made it. That is the case `authored` exists for, and
|
||||
picking `owns` for it is not a weaker edge but a wrong one.
|
||||
|
||||
`alternative-to` versus `contrasts` versus `compares-with`: `contrasts` asserts a *difference
|
||||
worth reading both for*, `alternative-to` asserts *substitutability* - two things a reader might
|
||||
pick between for the same job. `compares-with` weighs them on named dimensions, which in this
|
||||
instance is what routes to a `kb/comparisons/` page. Two agent CLIs are `alternative-to`; two
|
||||
opposed design principles are `contrasts`, and swapping the two says something false about both.
|
||||
|
||||
### Realization
|
||||
|
||||
@@ -135,6 +158,7 @@ Inference and comparison between ideas.
|
||||
| `contrasts` | differs from the target in a way worth reading both for |
|
||||
| `compares-with` | is weighed against the target on shared dimensions |
|
||||
| `contradicts` | asserts something the target denies |
|
||||
| `addresses` | is a response to the problem the target describes |
|
||||
| `composition` | is composed of the target |
|
||||
| `part-of` | is a component of the target |
|
||||
|
||||
@@ -149,6 +173,13 @@ about the same fact.
|
||||
listed separately rather than as inverses because either page may legitimately carry only its
|
||||
own side.
|
||||
|
||||
`addresses` is the edge from a solution to the problem it answers - a decision to the trouble
|
||||
that forced it, a mechanism to the failure it prevents. Keep it apart from `rests-on`, which
|
||||
takes the target as a *premise* the source argues from: a decision usually does both, and the
|
||||
one worth writing is the one a reader here would follow. `addresses` has no inverse. The problem
|
||||
page's inbound view already answers "what did anyone do about this?", which is the only reason
|
||||
someone would want the reverse.
|
||||
|
||||
### Lineage
|
||||
|
||||
Where something came from, and what replaced it.
|
||||
|
||||
Reference in New Issue
Block a user