Bug 38561

Summary: Fix broken internal reference links and update system preference descriptions
Product: Koha Reporter: Caroline Cyr La Rose <caroline.cyr-la-rose>
Component: DocumentationAssignee: David Nind <david>
Status: RESOLVED FIXED QA Contact: Testopia <testopia>
Severity: normal    
Priority: P5 - low CC: david, philip.orr, timdhannah
Version: MainKeywords: Academy
Hardware: All   
OS: All   
See Also: https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=41517
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/1160
Text to go in the release notes:
Version(s) released in:
Circulation function:

Description Caroline Cyr La Rose 2024-11-29 15:59:17 UTC
In the Administration preferences chapter, under ReplytoDefault (https://koha-community.org/manual/latest/en/html/administrationpreferences.html#replytodefault) and ReturnpathDefault (https://koha-community.org/manual/latest/en/html/administrationpreferences.html#returnpathdefault) the internal references are not formatted correctly.


"By default replies to notice emails will go to the `library email address <#libraries-groups>`__," 

The reference should have this format

:ref:`library email address <libraries-label>`



"By default bounced notices will go to the `library email address <#libraries-groups>`__,"

The reference should have this format

:ref:`library email address <libraries-label>`


I would also review those run-on sentences and cut them up.
Comment 1 Tim Hannah 2025-11-22 02:10:47 UTC
Needs clarity of default / fallback email addresses. Returnpathdefault Asks and Description disagree with each other
Comment 2 David Nind 2026-01-06 22:20:17 UTC
I've expanded this bug and submitted a merge request to fix all the current broken internal reference links for the:
- ReplytoDefault, ReturnpathDefault, and UsageStatsLibraryName 
  system preferences (administration system preferences)
- SvcMaxReportRows system preference (web services system preferences)

I have updated the 'Asks' text to match what is in Koha.

I've also updated the descriptions as required, including some minor edits (such as using the active voice).

For the ReplytoDefault and ReturnpathDefault system preferences:
1. I experimented with sending emails.
2. If a library-specific address is not set, the default is used.
3. If neither are set, then no 'Reply-To' or 'Return-Path' headers 
   are set in emails.
4. The fallback is to use the 'From' address, which is the library's 
   email address. If that is not set, then the KohaAdminEmailAddress is used.
5. I've updated the descriptions to hopefully reflect this, and hope I have 
   got this right!