diff --git a/CHANGES.md b/CHANGES.md index c52ed8a..358916d 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -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 ### Konverter-Tests gegen echte Dokumente im privaten Repository diff --git a/VERSION b/VERSION index 34befc4..164ecff 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -10.1.0-beta.3 +10.1.0-beta.4 diff --git a/instructions/dev/converter-comparison.md b/instructions/dev/converter-comparison.md index c196190..b21e3c4 100644 --- a/instructions/dev/converter-comparison.md +++ b/instructions/dev/converter-comparison.md @@ -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. @@ -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