Download here - OoCities
Transcript
Chapter 4 Terminology 95 memory expansion card Lowercase in generic references memory pages Used in A/UX documentation. Use lowercase, and spell out page numbers if you give them, to distinguish from display pages: zero page, page one. menu command Use command or menu command in user manuals; do not use menu option. A menu command is in a menu, not on a menu; a menu contains commands. See also command names. menu titles Note capitalization: Edit menu, File menu, and so on. menu types Note hyphenation: pop-up menu, pull-down menu, tear-off menu. metasymbols Refers to artificial terms that have meaning only in your manual and are to be replaced by a value or symbol. In running text, use italic regular text font when referring to a metasymbol, and spell out the metasymbol just as it would appear in a syntax description. Use plain style when using the name of a metasymbol in ordinary prose. Correct: Replace volume-name with a name of up to 12 characters. Correct: The volume name may have up to 12 characters. Incorrect: The volume-name may have up to 12 characters. mice Do not use; use mouse devices. micro disk, micro diskette, microfloppydisk ette Do not use; use disk. mini (prefix) Hyphenate before a word beginning with a vowel; close up before a word beginning with a consonant. mini-assembler, miniwindow, minicircular connector miniwindow Refers to a box appearing in some applications that has some but not all features of a regular window. Do not use window. minus sign Not minus symbol. Use an en dash for a minus sign (except in code, where a hyphen is used). MIPS Acronym for million instructions per second. Spell out on first occurrence. Do not drop the s when you are referring to a single unit: one MIPS, not one MIP. mode Avoid in user manuals when referring to software (for example, when describing a paint program, say, “When using the paintbrush,” not “When you are in paintbrush mode.”) In technical documentation, when referring to software, you enter or leave a mode; you don’t turn on or turn off a mode. model Do not use when you could use computer. Handbook for Technical Writers