Difference between revisions of "Help:Editing"
From PC-BSD Wiki
Tigersharke (Talk | contribs) m (→Reference) |
Tigersharke (Talk | contribs) m |
||
| Line 1: | Line 1: | ||
{{NavHome|custompagename=Help:Editing}} | {{NavHome|custompagename=Help:Editing}} | ||
| − | + | __NOTOC__ | |
===Typographic Conventions=== | ===Typographic Conventions=== | ||
Revision as of 01:19, 31 January 2012
| Help:Editing |
|
Typographic Conventions
The PC-BSD Handbook uses the following typographic conventions:
- bold text: represents a command written at the command line. In usage examples, the font is changed with any command output displayed in unbolded text.
- italic text: used to represent device names or file name paths.
- bold italic text: used to emphasize an important point.
Language usage and word choice
To facilitate future translations avoid the following:
- Contractions
- in place of don't, can't or won't use do not, cannot, or will not.
- Avoid brand names
- use web search instead of Google search
Special Characters
- Traversal of menus/windows
- use an arrow (➜) as in the example: PC-BSD control panel ➜ System manager ➜ System packages {tab}
|
|
|
- → ➿ ➙ ➜ arrows pointing to the right
- ← arrow pointing to the left
- unicode DB
- wikipedia:Arrow (symbol)
- wikipedia:Letterlike Symbols
- wikipedia:dingbat
- Wikimedia: Help:Editing
- Technical Writing rules FAQ - related to highly technical assembly/maintenance manuals but we can take note of a few useful points from the FAQ.
- E Prime - would likely reduce the challenge to translations.
- wikipedia:E-Prime#Discouraged_forms_and_rationale_for_typical_replacements