This is an old revision of the document!
Table of Contents
Victron Manual of Style (MoS)
The Victron Manual of Style (MoS), is a set of evolving and aspirational standards for the writing and design of documents. Victron's MoS is relevant to all documents that we produce, be they in digital, paper or web format.
Acronyms
Start a document with the full name of the acronym and then the acronym in brackets. Use just the acronym after that. Example: Battery Management System (BMS) and thereafter use just BMS.
Language
Use British English, as opposed to USA English.
Numbers
The following example shows the decimal mark and the thousands separator usage for both currency and non-currency numbers.
1,234,567.89
Ref: http://en.wikipedia.org/wiki/Decimal_mark#Examples_of_use
Punctuation
A basic guide to punctuation: http://stylematters.margaretashworth.com/punctuation/
Product Acronyms
Consider
- Capitalisation,
- Punctuation, and
- Omission or inclusion of spaces or hyphenation.
List of words that are often written incorrectly:
- VE.Direct
- VE.Bus
- VE.Can
- CAN-bus
- VictronConnect
- VEConfigure
- Color Control GX → CCGX
- Venus GX → VGX
- CCGX/VGX - Referred to collectively as the Venus-device.
- Equalisation (Not Equalization)
Style
If in doubt The Economist has one of the best style guides I know of: http://www.economist.com/styleguide/introduction
Type Faces Used
- MyriadPro-Bold
- MyriadPro-It
- Helvetica Neue regular, bold and condensed black
- Arial regular and bold