instructions/dev: converter-comparison nennt harness/compare/README.md als Ort der Einrichtung statt der README des privaten Repos (#233 close); 10.1.0-beta.4
CI / verify (push) Successful in 7m53s
CI / pwsh (push) Successful in 2m44s
Release / converters (push) Successful in 27s
Release / release (push) Successful in 36s
Release / wiki-mirror (push) Skipped

Files changed:
- CHANGES.md
- VERSION
- instructions/dev/converter-comparison.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
torbenandClaude Opus 5.5 committed 2026-10-14 18:31:35 +02:00
1 parent d393e2ffe1
commit 01360e9045
3 files changed
+7 -6

No files matched your search

+2 -1
View File
@@ -14,7 +14,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model.
---
## 10.1.0-beta.3 - 2026-10-14 - instructions/dev: Konverter-Vergleich – eigene Ableitung gegen Referenzwerkzeuge am privaten Korpus, mit Grundlinie
## 10.1.0-beta.4 - 2026-10-14 - instructions/dev: converter-comparison nennt harness/compare/README.md als Ort der Einrichtung
**Author:** Torben Nehmer
@@ -25,6 +25,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model.
**Low impact**
- instructions/dev: Konverter-Vergleich – eigene Ableitung gegen Referenzwerkzeuge am privaten Korpus, mit Grundlinie
- instructions/dev: converter-comparison nennt harness/compare/README.md als Ort der Einrichtung
<!-- /wikitool:bumps -->
### Konverter-Tests gegen echte Dokumente im privaten Repository
+1 -1
View File
@@ -1 +1 @@
10.1.0-beta.3
10.1.0-beta.4
+4 -4
View File
@@ -15,7 +15,7 @@ and struck through 190 single letters along the grid lines of rotated table page
The comparison runs in the private repository `chemenu-testfiles` (cloned into `testfiles/`,
[dev-setup.md](dev-setup.md) step 6): `harness/compare/compare.py` derives every corpus file with
this checkout's filters and with the reference tools, computes the measures, and reports the
difference to `harness/baseline.json`. Its README has the setup and every option; this file says
difference to `harness/baseline.json`. `harness/compare/README.md` has the setup and every option; this file says
when to run it and what to do with the result.
<!-- wikitool:toc -->
@@ -64,7 +64,7 @@ Docling is the heavy comparison for when the starting set leaves a question open
by hand into the same environment and is not part of the routine run.
**A reference tool is never a dependency of the stack.** It lives in `harness/compare/.ref-venv`,
a throwaway environment the README builds, never in `tools/.venv` and never in
a throwaway environment that `harness/compare/README.md` builds, never in `tools/.venv` and never in
`tools/requirements.txt`. `compare.py` runs with `tools/.venv` (so it measures this checkout's
filters) and starts the reference tools as a separate process.
@@ -98,8 +98,8 @@ the price of any wrong ones is not an improvement until the wrong ones are gone.
## Steps
1. **Have the clone and the reference environment.** The README of the private repository builds
the environment in one command; check it is there:
1. **Have the clone and the reference environment.** `harness/compare/README.md` builds the
environment in one command; check it is there:
```bash
ls testfiles/harness/compare/.ref-venv/bin/python