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.

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

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 a GX device.
  • Equalisation (Not Equalization)

GX Product Classifications

  • GX product range - all GX devices (eg CCGX), and their accessories (eg GX GSM).
  • GX device - any member of that family eg Venus GX and Octo GX, but not inclusive of the accessories.
  • GX Card - a circuit board featuring all the GX features that is used in the integrated products, eg EasySolar-II GX and MultiPlus-II GX.

Products that have the GX suffix are a GX device, or contain a GX device.

Products that have a GX prefix are accessories for a GX device.

Generally, public/external use of the terms 'Venus' & 'Venus device' is now depreciated, and should be replaced with 'GX device' instead.

Specific internal/technical use of 'Venus OS' to refer to the open source operating system software development that runs on the GX devices is still correct.

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

Units

Use the International System of Units. for more info see Wikepedia.

There should be a space between the value and the unit. Example 12 V.

When using a symbol as prefix, like m for milli, K for kilo or M for mega, these are written either capitalized or are lowercase. The symbols for mega and above are capitals, while kilo and below are lowercase. Example 12 MW, 5 kVA and 10 mA.

Victron Energy departments names and definitions

Repair Centre (previously called Service Partner) - these are external companies (customers) who perform product repairs on behalf of the Victron Energy Service department

drafts/victron_manual_of_style.1573630594.txt.gz · Last modified: 2019-11-13 08:36 by mleeftink

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki