Skip to content

Soracom

Design System
Home Design System Guidelines Grammar

Grammar

To ensure consistency across all written content, the following rules should be followed.

Capitalization 

Use sentence case for all text:

  • Capitalize only the first word of a heading
  • Capitalize only the first word of a sentance;

Use title case for:

  • Soracom services: i.e. Beam, User Console
  • The pronoun “I”: i.e. The last time I travelled was several years ago
  • Proper nouns (the names of specific people, places, organizations, and sometimes things)
  • The days of the week, the months of the year, and holidays (but not the seasons used generally)
  • The names of countries, nationalities, and specific languages;

Use upper case for:

  • Soracom platform: i.e. SORACOM Beam, SORACOM User Console
  • Abbreviations i.e. SIM, CLI

Exceptions 

Note, some services/names have specific conventions outsite the above rules: i.e. LoRaWAN, IoT

Examples 

Abbreviations 

Setting a SIMs expiration date will prevent new sessions being created after the specified date.
Manage your network and devices in real time with a built-in user console and API

Setting a sims expiration date will prevent new sessions being created after the specified date.
Manage your network and devices in real time with a built-in user console and api

When referring to the company “Soracom” 

Founded by Amazon AWS veterans and telco engineers, Soracom is a global team of technologists, strategists, builders and storytellers dedicated to creating a more connected world.
Founded by Amazon AWS veterans and telco engineers, SORACOM is a global team of technologists, strategists, builders and storytellers dedicated to creating a more connected world.

When referring to the platform or service 

SORACOM Beam
Collect, store, and visualize data at any time, from any device connected with SORACOM Air. No server or storage setup required.

Soracom Beam
Collect, store, and visualize data at any time, from any device connected with Soracom Air. No server or storage setup required.