User Tools

Site Tools


drafts:victron_manual_of_style

This is an old revision of the document!


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.

A

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.

L

Language

Use US English, as opposed to UK English.

N

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

P

Punctuation

Product Acronyms

Consider

  • Capitalisation,
  • Punctuation, and
  • Omission or inclusion of spaces.

VE.Direct

VE.Bus

VE.Can

CAN-bus

VictronConnect

VEConfigure

CCGX

Color Control GX

VENUS GX

CCGX/VENUS GX - Referred to collectively as 'VENUS device'.

S

Spelling

There are several areas in which British and American spelling are different. Use the American spelling.

Ref:http://www.oxforddictionaries.com/words/british-and-american-spelling

Style

If in doubt The Economist has one of the best style guides I know of: http://www.economist.com/styleguide/introduction

~~DISQUS~~

drafts/victron_manual_of_style.1528287889.txt.gz · Last modified: 2018-06-06 14:24 by guystewart

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki