ContactsLaw Documentation:Style Guide: Difference between revisions
No edit summary |
|||
Line 36: | Line 36: | ||
* Less is more, don't over-decorate | * Less is more, don't over-decorate | ||
* NEVER USE ALL CAPS | * NEVER USE ALL CAPS | ||
== Links == | |||
* Create internal links to other articles wherever they are known to exist (and update your articles to include them once they '''do''' exist) | |||
* Do not over-link, only decorate the first occurrence (or first per heading if appropriate) | |||
* Override the link text if you need to use the plural form of a word (e.g. ''Contact|contacts'') or other variations | |||
* '''Do not''' use link text that is completely different to the article name (e.g. ''Matter|file'') | |||
== Special Features == | == Special Features == |
Revision as of 09:43, 24 April 2024
Contributions to this wiki should follow this style guide.
How To Use This Wiki
This wiki is implemented using MediaWiki, which is the same software that powers Wikipedia.
For general help with MediaWiki, refer to MediaWiki Help.
Key topics include:
Naming Conventions
Article Names
- Use the singular form (e.g. Contact, not Contacts)
- Capitalise Each Word
- Choose the shortest possible name (that isn't ambiguous)
- Prefix with a category name to resolve ambiguity (e.g. Document:Template)
Headings
- Capitalise Each Word
- Be consistent with other articles
- External Links should always be last (if included)
Formatting
- Use bold formatting to introduce the main topic of the article (and other key terms)
- Use italic formatting for notes and remarks
- Use
monospace
formatting for code, expressions and other syntax - Less is more, don't over-decorate
- NEVER USE ALL CAPS
Links
- Create internal links to other articles wherever they are known to exist (and update your articles to include them once they do exist)
- Do not over-link, only decorate the first occurrence (or first per heading if appropriate)
- Override the link text if you need to use the plural form of a word (e.g. Contact|contacts) or other variations
- Do not use link text that is completely different to the article name (e.g. Matter|file)
Special Features
External Links
- Wikipedia Manual of Style - For any topics not covered here, you should refer to Wikipedia's style guide.