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?
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.
We have removed the help pages in favor of links to the manual since, making this bug obsolete: bug 19817