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 **Author:** Torben Nehmer
@@ -25,6 +25,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model.
**Low impact** **Low impact**
- instructions/dev: Konverter-Vergleich – eigene Ableitung gegen Referenzwerkzeuge am privaten Korpus, mit Grundlinie - 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 --> <!-- /wikitool:bumps -->
### Konverter-Tests gegen echte Dokumente im privaten Repository ### 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/`, 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 [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 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. when to run it and what to do with the result.
<!-- wikitool:toc --> <!-- 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. 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 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 `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. 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 ## Steps
1. **Have the clone and the reference environment.** The README of the private repository builds 1. **Have the clone and the reference environment.** `harness/compare/README.md` builds the
the environment in one command; check it is there: environment in one command; check it is there:
```bash ```bash
ls testfiles/harness/compare/.ref-venv/bin/python ls testfiles/harness/compare/.ref-venv/bin/python