https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29712
Caroline Cyr La Rose <[email protected]> changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |caroline.cyr-la-rose@inlibr | |o.com --- Comment #1 from Caroline Cyr La Rose <[email protected]> --- Here are some notes that I took while I wrote documentation. It is what *I* do and is open to discussion Style guide GENERAL - When inserting links or references, have the text of the link be significant (also avoid links that say "click here"), for example - preferred form: :ref:`create a new authorized value category <add-new-authorized-value-category-label>` - non-preferred form: :ref:`create <add-new-authorized-value-category-label>` a new authorized value category - Use American English - Write 'system preference' in long form (rather than just 'preference') - Use 2nd person (you do this and that) SCREENSHOTS *- I try to take general screenshots that can be reused in many places, for example, I will take a screenshot of all options in a menu rather than very specific screenshots of a single button/option *- I classify the screenshots in the module where they were taken rather than where the screenshot is used in the manual, for example, a screenshot of an OPAC message in the OPAC will be classified in the OPAC directory even if it is used in the patrons chapter to show how it looks to the patron when you add a message in their file TITLES - Use verbs and present participle, for example - preferred form: Adding an authorized value - non-preferred form: Add an authorized value - non-preferred form: Creation of an authorized value - Always add a label, so that this section can be referred to elsewhere Descriptions - When describing a form, use a bullet list and each bullet should start with the label of the field, for example - preferred form: Name: this is the name of the field as you want it to appear. - non-preferred form: Enter the name as you want it to appear. - non-preferred form: Enter the 'Name' as you want it to appear. Formatting - Cut lines at 80 characters if possible (not always possible, esp. with tables) - If possible, do not cut ref links (I'm not sure if it changes anything, but my text editor doesn't highlight them if they are on multiple lines) - Follow bullet points with two spaces - End complete sentences with a period - Use single quotes, except if the content has an apostrophe - Use single quotes and capitalization for button names, for example - preferred form: Click the 'Submit' button. - non-preferred form: Click the submit button. TBD - Which tense to use in the text? - Present: the number of holds is displayed; the button is on the right - Future: the number of holds will be displayed; you will see the button on the right -- You are receiving this mail because: You are watching all bug changes. _______________________________________________ Koha-bugs mailing list [email protected] https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-bugs website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
