利用者:Jaredr122/wiki improvements
< 利用者:Jaredr122
2013年1月26日 (土) 14:00時点におけるwiki>Jaredr122による版
Wiki Improvements
See my Formatting Mockup
Formatting
Here are my suggestions for improved formatting:
- Literals: UI items should be bold, or bold+italic). Bold stands out better than italic alone
- Links: brighter blue to help them stand out
- Indent text/headings under ==heading 2== to better separate sections.
- Increase size of ==heading 2== to make it more separate from ===heading 3===
- Add a bar/background color to headings
- Left align when possible
Consistency and Simplification
Recommendations for consistent formatting:
- One =heading 1= per page, as recommended in the Mediawiki documentation
- Describe UI items/options with a clear separation between the word and the description
- Term on its own line, and the descriptions on next line, indented
- Not bulleted. Visually interferes with the word itself, and is consistent with most of the manual and other manuals
- Bullets are only for examples/lists of things
- Numbered lists for explanation of steps
- Tables are for larger lists with descriptions
- Use logical heading nesting
Recommendations for simplification:
- Omit unnecessary sub-headings, like ==Description==. (It should be assumed that what is written is a description).
- Avoid being verbose. Be concise.
- Don't include unnecessary images
- Remove "mode" from ref boxes, unless necessary