Bug 41542 - Update various system preference descriptions in the manual - order of sections, values, formatting
Summary: Update various system preference descriptions in the manual - order of sectio...
Status: RESOLVED FIXED
Alias: None
Product: Koha
Classification: Unclassified
Component: Documentation (show other bugs)
Version: Main
Hardware: All All
: P5 - low normal
Assignee: David Nind
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2026-01-08 03:07 UTC by David Nind
Modified: 2026-01-08 03:46 UTC (History)
3 users (show)

See Also:
GIT URL:
Initiative type: ---
Sponsorship status: ---
Comma delimited list of Sponsors:
Crowdfunding goal: 0
Patch complexity: ---
Documentation contact: David Nind
Documentation submission: https://gitlab.com/koha-community/koha-manual/-/merge_requests/1162
Text to go in the release notes:
Version(s) released in:
Circulation function:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description David Nind 2026-01-08 03:07:14 UTC
This bug covers changes to various system preference descriptions in the manual.

These changes were identified when reviewing merge requests for the manual, but were either minor changes, or not directly related to the merge request. Rather than leave them to later updates, I've fixed them on this bug.

It includes:
- Fixing the order of sections for a system preference, such as moving the default value to after the list of values.
- Updates to the 'Asks' section to match what is in Koha.
- Minor punctuation changes, such as adding missing full stops.
- Fixing formatting for admonitions, such as notes.
- Updating the list of values so that they match what is in Koha.
- Some edits to the description section, including:
  . passive voice to active voice
  . preference to system preference
  . making the descriptions clearer (hopefully)
Comment 1 David Nind 2026-01-08 03:27:26 UTC
System preference descriptions that were updated (this should cover most of them).

Cataloging
==========

- BibtexExportAdditionalFields: edit description - expand e.g., to
  for example, warning boxes - add full stops, colon, add emphasis
  (bold) to keywords
- MergeReportFields: add missing full stop
- RisExportAdditionalFields: edit description - expand e.g., to
  for example, warning boxes - add full stops, colon, add emphasis
  (bold) to keywords
- SubfieldsToAllowForRestrictedBatchmod: format of note (currently
  just bold), removed unnecessary sentence
- SubfieldsToAllowForRestrictedEditing: format of note (currently
  just bold), removed unnecessary sentence


Circulation
===========

- AllFinesNeedOverride: remove spaces at the end of a line
- AllowRenewalLimitOverride: move default section, note: formatted
  asks section differently than what it is in Koha to make it easier
  to read using an unordered list (it is a very long sentence - to
  add bug to fix), edited description section - including changing
  passive voice to active voice
- AllowReturnToBranch: move default section, put values in order
  and remove full stop, changed preference to system preference
- HoldsSplitQueue: move default section
- OnSiteCheckoutAutoCheck: edit description section - preference
  to system preference, move default section
- OPACFineNoRenewalsBlockAutoRenew: move default to after values,
  update values (in lower case)
- RenewAccruingItemWhenPaid: move default section, removed note
  (made part of description), updated order of values
- ReturnBeforeExpiry: move default section, minor edits to description
  (comma, add system preference)
- UseTransportCostMatrix: move default section, match asks section to
  text in Koha, minor edits to description section


OPAC
====

- OpacHighlightedWords and NotHighlightedWords: add a colon after the
  stopwords in the asks section, add a full stop at the end of the
  sentence, moved default section, changed "Values" to values
- OPACUserSummary: add missing full stop, values added, moved default
  section


Patrons
=======

- CollapseFieldsPatronAddForm: update list of values to match Koha, 
  minor edits to description (passive to active), add full stop to 
  asks section
- PrefillGuaranteeField: update list of values tomatch Koha, edit
  description - passive to active


Staff interface
===============

- TwoFactorAuthentication: move default section, minor edits - 
  passive to active



Web services
============

- IdRef: edited the description section
- OAI-PMH:AutoUpdateSets: move default section