Bug 24501 - Authorities 'merge' is confusing
Summary: Authorities 'merge' is confusing
Status: NEW
Alias: None
Product: Koha
Classification: Unclassified
Component: MARC Authority data support (show other bugs)
Version: Main
Hardware: All All
: P5 - low normal (vote)
Assignee: Bugs List
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2020-01-23 18:49 UTC by Nick Clemens (kidclamp)
Modified: 2024-02-15 19:31 UTC (History)
7 users (show)

See Also:
Change sponsored?: ---
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Nick Clemens (kidclamp) 2020-01-23 18:49:01 UTC
While authority updates sometimes happen because of the merging of authorities, authority record edits also cause a need to 'merge'

Perhaps the cronjob and sysprefs should refer to 'updating' authorities?
Comment 1 Andrew Fuerste-Henry 2020-01-23 19:24:52 UTC
There's a function within Koha two take two authority records and combine them into one authority record. Koha refers to this as merging. That's a good name for that and doesn't confuse people.

But then there's also a cron job that takes changes made to authority records and pushes them out to bibs. Koha also refers to this as merging. This *does* confuse people. They see a cron called "merge_authorities.pl" and assume it's going to clean up duplicate authorities or something.

So I'd propose renaming the cron and the various system preferences that refer to the cron, though I understand that's a change to a very well-established Koha feature.
Comment 2 Katrin Fischer 2020-01-24 22:28:02 UTC
I understand that it is confusing, but changing a cronjob name means that in every installations people might have to change their cronjob setup... I am not sure if we should do this. And if we do it, maybe it should be a gradual process turning the current script into a wrapper that sends a deprecation warning to the logs for one release and asks you to switch.
Comment 3 Marcel de Rooy 2020-01-25 10:37:33 UTC
From ExLibris:
Authorities - Preferred Term Correction – This job performs preferred term correction on all bibliographic records that are linked to authority records using the Authorities - Link BIB Headings job. For example, if a bibliographic record contains the non-preferred term “Narcotics, Control of,” and the associated authority record contains the preferred term “Drug control,” the Authorities – Preferred Term Correction job replaces “Narcotics, Control of” with the preferred term “Drug control.” Bibliographic records are also updated with any subsequent updates to authority records.

=> The general term updating is used here in connection with preferred term correction.
Comment 4 Marcel de Rooy 2020-01-25 10:39:35 UTC
OCLC: Once you control a heading (and add or replace the record in WorldCat), the heading in the bibliographic record is automatically updated whenever the linked authority record changes.
Comment 5 Marcel de Rooy 2020-01-25 10:44:16 UTC
(In reply to Katrin Fischer from comment #2)
> I understand that it is confusing, but changing a cronjob name means that in
> every installations people might have to change their cronjob setup... I am
> not sure if we should do this. And if we do it, maybe it should be a gradual
> process turning the current script into a wrapper that sends a deprecation
> warning to the logs for one release and asks you to switch.

We have renamed cron jobs in the past. But I agree that we should not do that too often ;) In this case I think it is more important to update interface, documentation etc. and even the routine name (C4::AuthoritiesMarc::merge) than renaming the script and cronjobs.
Comment 6 David Cook 2021-03-22 00:02:25 UTC
(In reply to Marcel de Rooy from comment #5)
> We have renamed cron jobs in the past. But I agree that we should not do
> that too often ;) In this case I think it is more important to update
> interface, documentation etc. and even the routine name
> (C4::AuthoritiesMarc::merge) than renaming the script and cronjobs.

Agreed. Having a legacy script name isn't too big of a problem, if you can open that file and see that it's about processing heading updates in bib records from authority records.
Comment 7 Catrina Berka 2023-01-23 15:14:08 UTC
While the documentation has great warning notes about the actual function of this cron, I agree with the previous comments that renaming it will reduce confusion. Any plan, however slow, that moves us towards this end would be welcome.
Comment 8 Esther Melander 2024-02-15 19:31:55 UTC
Even if the cron is not renamed, it would be helpful to rename the system preference AuthorityMergeLimit to AuthorityLinkLimit or something similar and provide clarifying language in the system preference description.

These system preferences should be considered for clarification/renaming:

AuthorityMergeLimit
AuthorityMergeMode