Bug 7920

Summary: Establish style guide for Koha help pages
Product: Koha Reporter: Owen Leonard <oleonard>
Component: DocumentationAssignee: Chris Cormack <chris>
Status: CLOSED INVALID QA Contact:
Severity: enhancement    
Priority: P5 - low CC: katrin.fischer
Version: Main   
Hardware: All   
OS: All   
See Also: https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=19817
Change sponsored?: --- Patch complexity: ---
Documentation contact: Documentation submission:
Text to go in the release notes:
Version(s) released in:

Description Owen Leonard 2012-04-06 14:33:12 UTC
In my work on Bug 2780 I'm finding some inconsistency in the way the help pages are styled and punctuated. I think it would be a good idea to establish some rules about how we express some things:

- How should system preference names be quoted and/or styled?
- How should Koha modules be quoted and/or styled?
- How should we style common elements like 'hints' and 'Important:' blocks?

Also:

- Should we link system preference mentions to the corresponding help page?
Comment 1 Nicole C. Engard 2013-05-21 13:35:23 UTC
The problem here is that it's all copied from the manual and as I'm the only one writing the manual I often just write as quickly as I can to get the content in there.  Any style changes to the help files should be made in the manual as well since it's just a copy/paste effort.

As for linking prefs - I'm A-OK with that. I do that in the manual, but was removing those links from the help files because I figured that we didn't want to link out.
Comment 2 Katrin Fischer 2019-03-14 07:33:09 UTC
We have removed the help pages in favor of links to the manual since, making this bug obsolete: bug 19817