Gloss — 25-note spot review

Parent: Corpus results. Qualitative comparison of the filtered 14,554-atom pursuit against the original 65-atom pursuit.

The original nine examples plus one SHA-256-minimum-key selection from each of 16 named families: popit3, pwsafe, Z80-sudoku-challenge, delayrepay, ask, location-db, personal, proposals, astronomy, poems, uucp, ansible, music, hosts, fitness and ssl. Selection is reproducible in review-sample.json. This is an agent spot review of representative source passages, not blind human scoring or a held-out benchmark. Every key was processed numerically; only these 25 receive qualitative verdicts.

Judgements: {'Worse': 5, 'Improved': 13, 'Mixed': 7}. Treat these as examples of benefits and failure modes, not a corpus accuracy estimate.

SourceOriginal glossFiltered expanded glossComparisonReason
PROGRAMMING_RULES/philosophycorrectness; philosophy; Pythoncorrectness notes; philosophies; arbitrary pythonWorseCorrectness notes and philosophies are relevant, but arbitrary python adds a misleading specificity absent from the original correctness/philosophy/Python gloss.
PROGRAMMING_RULES/exceptionserror handling; Python; exceptionexception handling; perl python; general principlesWorseException handling is precise, but perl python introduces Perl into a Python-only policy. Negation is still absent. The direct-cosine labels are redundant but more faithful here.
ideas/concept-factorisationversioning; hypertext; matching pursuitconcept notes; indexing; concept factorisation hierarchicalImprovedConcept notes, indexing and concept factorisation hierarchical describe the purpose more directly than versioning/hypertext/matching pursuit, though the phrases are clumsy.
first-thoughts/representation-not-languageembedding; matching pursuit; reasoningopen questions weak; note embeddings; behavioural equivalenceWorseOpen questions weak is a heading fragment. Note embeddings is relevant but the representation-versus-language thesis is not captured. More phrases have introduced boilerplate competition.
gdata-server/notes/designnote; API; software designgdata notes; notes client; python moduleImprovedGdata notes, notes client and python module identify the actual component more specifically than note/API/software design.
envoy/design-phasesworkflow; versioning; summarisingimplementation notes; processing state machine; envoyresponse schemaImprovedProcessing state machine and envoyresponse schema are specific and relevant. Implementation notes remains generic; this is better topical coverage, not a complete summary.
README/orphaningversioning; note; orphaningavoiding orphaned notes; metadata and links; design documentationImprovedAvoiding orphaned notes and metadata and links capture the purpose and even retain an avoidance framing that a single orphaning label cannot express.
TFG/exercise-demo-protocolexercise; demonstration; coachingfunctional exercise; review and handover; sample demonstrationsWorseFunctional exercise and sample demonstrations are related, but review and handover is misplaced. The original exercise/demonstration/coaching gloss is clearer.
using-gps-dataGPS; matching pursuit; versioningchecks gazetteer comparisons; project notes; answered nearest stationMixedGazetteer comparisons and nearest-station language are more relevant than matching pursuit/versioning, but project notes is generic and the phrases read like fragments. The expanded direct-cosine baseline is cleaner.
popit3/opserror handling; logging; orphaningmaildir test completion; computer crash occurred; popsWorseMaildir test completion and computer crash occurred misdescribe a reference dominated by a POP3 EOF/spinning-process bug and recovery. Broader vocabulary introduces a misleading test/crash story.
pwsafe/transport/plansoftware design; deployment; versioningpwsafe article revision; transport plugin; current phaseMixedTransport plugin and current phase are relevant improvements, but pwsafe article revision describes the wrong activity.
Z80-sudoku-challenge/code/deterministic-fill-loopprogramming; matching pursuit; fastestdeterministic fill loop; address of cell; bit candidate maskImprovedDeterministic fill loop, address of cell and bit candidate mask are directly relevant; the old programming/matching pursuit/fastest gloss was too generic and misleading.
delayrepay/session-2026-08-29-kombu-decommissionlogging; orphaning; command linefirefox vnc; kombu; automated via ansibleImprovedFirefox VNC, kombu and automated via ansible identify the setup being dismantled. It still misses the crucial terminated/decommissioning status.
ask/jobs/schemaJSON; software design; versioningjson schema; cover letters; docx generationImprovedJSON schema, cover letters and DOCX generation capture the document-generation purpose, substantially better than JSON/software design/versioning.
location-db/outcodes-1degGPS; JSON; timetablebristol bath newport; postcodes; cardiff gloucester swindonImprovedPostcodes and the covered cities are meaningful. The city-list fragments remain awkward, and the geographic bounding rule is missing. This long table is chunk-averaged.
personal/interestsGPS; software design; astronomyinterests hobbies; GPS; john has askedMixedInterests hobbies is a better umbrella label, GPS is relevant, but john has asked is boilerplate and other interests disappear.
proposals/section-editingversioning; JSON; hypertextjsonhtl documentation improvements; completed section; semantic specMixedJSONHTL documentation improvements is relevant but generic; completed section and semantic spec do not clearly convey nested containers or heading-path addressing.
astronomy/eclipse-2026astronomy; GPS; timetablepath of totality; bristol london; solar eclipseImprovedEclipse-specific labels and the totality path are much more informative than astronomy/GPS/link. Later place/source labels still need checking against the intended topic.
poems/first-to-Kathypoetry; journey; emailkathy; summer poem; foreverMixedKathy and forever capture recipient and enduring affection. Summer poem adds a season that the poem does not establish.
uucp/setup-statusauthentication; versioning; command linetaylor uucp; existing stunnel; protocol restrictionsImprovedTaylor UUCP and existing stunnel identify the mechanism; protocol restrictions is broadly relevant. This beats the old generic authentication/versioning/command line result.
ansibleversioning; API; notegit ansible; private notes store; hostnamesImprovedThe Ansible-specific lead is more useful than versioning/API/note. Private notes store is not a safe summary of the warning that secrets must never go into notes; polarity still needs source reading.
music/exercise-folk-rockfitness; music; matching pursuitexercise music; functional exercise; shantiesImprovedExercise music and shanties capture the joint subject. Functional exercise is broad, but the spurious matching pursuit label is gone.
hosts/gravlaxversioning; logging; hypertextwebdav notes; gravlax and kelp; freebsd hostMixedWebDAV and gravlax/kelp are relevant; freebsd host is a wrong-host/OS association. Broader labels improve recognition while introducing a false specific.
fitness/bodypump-attendancefitness; timetable; JSONbodypump; david lloyd schedule; bristol minima shownMixedBODYPUMP and David Lloyd context are more specific, but the later label must not be mistaken for a faithful description of monthly attendance counts.
ssl/certhub-todoAPI; versioning; hypertextcertificate configuration; certhub; future workImprovedCertificate configuration, certhub and future work capture both the domain and the status of this short backlog.
version 1  ·  created 2026-09-18  ·  updated 2026-09-18  ·  tags gloss, corpus, embeddings, results