Bug 15003 - Help should be a wiki, not translatable via po-files
Summary: Help should be a wiki, not translatable via po-files
Status: RESOLVED WONTFIX
Alias: None
Product: Koha
Classification: Unclassified
Component: Staff interface (show other bugs)
Version: unspecified
Hardware: All All
: P5 - low enhancement (vote)
Assignee: Bugs List
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-10-13 10:21 UTC by paxed
Modified: 2023-06-01 20:17 UTC (History)
4 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 paxed 2015-10-13 10:21:21 UTC
[Note: This is brainstorming based on feedback from Vaarakirjastot]

Po-files split the help pages into sentences, or worse, into sentence fragments.
This makes translating them into fluent language nearly impossible, because they
are text articles and direct sentence translation makes bad prose.

Each help page should be a single translatable element.

As the help pages are already sort-of like wiki, and editable in Koha itself,
it would make sense to package the actual help pages for each language
separately, which could then be installed (either in Koha itself, or by
external means).

And/Or perhaps there could be a syspref to use external URL instead of
local help, with some substitutions for language, Koha version, and
the help article. For example, setting the syspref value to
"http://help.koha-community.org/wiki/${lang}/${version}/${article}"
would open that page on a wiki set up there.
Comment 1 Katrin Fischer 2020-01-08 07:24:59 UTC
Hi Paxed, 

there is quite a few different requests in this one - would you mind reviewing what is still needed since we changed from help files to links to the manual? URL is configurable now for example.
Comment 2 Katrin Fischer 2023-06-01 20:17:16 UTC
Closing this one as the suggestions were based on the old help system that used templates in Koha. Remaining issues could be filed as new bugs.