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

scientific annotations

The unit is written with a capital When using a metric prefix some are written with a capital and the other are lowercase Mega and above are capital, and below are lowercase with , like mega, kilo, milli, these are written lowercase Fist number then a space an then then a unit Example: 5000 kW

drafts/victron_manual_of_style.1568079015.txt.gz · Last modified: 2019-09-10 03:30 by mleeftink

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki