style_guide.mdwn 1.65 KB
Newer Older
1 2 3 4 5
- Bulleted lists

  Refer to this article from NN/g on [presenting bulleted
  lists](https://www.nngroup.com/articles/presenting-bulleted-lists/).

sajolida's avatar
sajolida committed
6
- *Debian and Ubuntu version*
sajolida's avatar
sajolida committed
7

sajolida's avatar
sajolida committed
8 9
  Refer to Debian versions primarily by their number, and additionally
  by their codename.
sajolida's avatar
sajolida committed
10

sajolida's avatar
sajolida committed
11 12 13
  * *For example*:
    - Tails 3.0 is based on Debian 9 (Stretch)
    - *Tails Installer* is available on Ubuntu 15.10 (Wily Werewolf) or later.
14 15 16 17 18 19 20 21 22 23 24

- **digit grouping**

  Use a thin space (HTML entity: ` `) or a space to separate
  groups of three digits.

  * *For example*:
    - $50 000

  See [[!wikipedia Decimal_separator#Digit_grouping]] and [[!wikipedia
  ISO_31-0#Numbers]].
25

sajolida's avatar
sajolida committed
26 27
- **graphics card**

28 29
  And not *graphics adapters*, *graphics*, *graphical hardware*, or
  *video card*.
sajolida's avatar
sajolida committed
30

sajolida's avatar
sajolida committed
31 32 33 34 35 36
- **network interface**, **Wi-Fi interface**

  And not *card*, *device*, or *adapter*.

  Still, **USB Wi-Fi adapters** are USB dongles that provide a Wi-Fi interface.

37 38 39 40 41 42 43 44 45 46 47
- **persistence feature**

  To refer to the features available in the configuration of the
  *persistent volume*.

  - *For example*: when the <span class="guilabel">Additional
    Software</span> persistence feature is activated.

  The word *persistence* can be omitted if it is redundant from the context
  (for example on [[doc/first_steps/persistence/configure]]).

sajolida's avatar
sajolida committed
48 49 50 51 52 53 54
- **startup options**

  To refer to the kernel command line options that can be specified from
  the *Boot Loader Menu*.

  * *For example:* Adding `radeon.dpm=0` to the [[startup
    options|/doc/first_steps/startup_options#boot_menu]].
55

sajolida's avatar
sajolida committed
56
- **<span class="application">Tails Greeter</span>**
57

sajolida's avatar
sajolida committed
58
  Without an article. Not *the Greeter*. Note the formatting as an application.