From 17cd7f35170a6d5aa203db0c5814c67d8d6547f9 Mon Sep 17 00:00:00 2001 From: Martin Renvoize Date: Tue, 15 Sep 2026 13:50:24 +0100 Subject: [PATCH] Bug 31925: Document that thesaurus-aware linking depends on index freshness QA (comment 58/60) suggested LinkerConsiderThesaurus only works with Elasticsearch, having observed duplicate authorities being created when testing with Zebra. Reproduced this directly: with AutoCreateAuthorities and LinkerConsiderThesaurus on, saving two bibs with the same new FAST heading back-to-back (no pause) creates a duplicate authority under Zebra, but waiting for Zebra's indexing daemon to catch up (a few seconds) between saves lets the second heading link to the first-created authority correctly, as designed. The same duplicate-on-rapid-succession behaviour also reproduces with LinkerConsiderThesaurus off and a plain LCSH heading - it's a pre-existing race between AutoCreateAuthorities and Zebra's asynchronous indexing daemon, not something specific to thesaurus-aware matching or this bug. Elasticsearch indexes near-synchronously within the same request, so the same race window is far less likely to be hit there, which is almost certainly why this only showed up in manual Zebra testing. This documents that dependency on the LinkerConsiderThesaurus system preference description, rather than gating the feature to Elasticsearch only, since the underlying logic is search-engine agnostic and works correctly on Zebra given normal indexing latency. Sponsored-by: Heythrop Library Co-Authored-By: Claude Sonnet 5 Signed-off-by: David Cook Signed-off-by: Pedro Amorim --- .../prog/en/modules/admin/preferences/authorities.pref | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/authorities.pref b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/authorities.pref index e0e7c73fc2..390306a62a 100644 --- a/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/authorities.pref +++ b/koha-tmpl/intranet-tmpl/prog/en/modules/admin/preferences/authorities.pref @@ -155,7 +155,7 @@ Authorities: choices: 1: Do 0: "Don't" - - compare the source for 6XX headings to the thesaurus source for authority records when linking. Enabling this preference may require a reindex, and may generate new authority records if AutoCreateAuthorities is enabled. + - compare the source for 6XX headings to the thesaurus source for authority records when linking. Enabling this preference may require a reindex, and may generate new authority records if AutoCreateAuthorities is enabled. Matching relies on the search index being up to date, so headings imported in quick succession may generate extra authority records until indexing (Zebra's indexing daemon, or Elasticsearch) catches up. - - pref: LinkerConsiderDiacritics default: no