style_guide.mdwn 2.33 KB
Newer Older
1 2
[[!meta title="Documentation style guide"]]

sajolida's avatar
sajolida committed
3
- **bulleted lists**
4 5 6 7

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

cbrownstein's avatar
cbrownstein committed
8
- **Debian and Ubuntu versions**
sajolida's avatar
sajolida committed
9

cbrownstein's avatar
cbrownstein committed
10 11
  Refer to Debian and Ubuntu versions primarily by their numbers, and additionally
  by their codenames.
sajolida's avatar
sajolida committed
12

sajolida's avatar
sajolida committed
13 14 15
  * *For example*:
    - Tails 3.0 is based on Debian 9 (Stretch)
    - *Tails Installer* is available on Ubuntu 15.10 (Wily Werewolf) or later.
16

sajolida's avatar
sajolida committed
17 18
<a id="digit_grouping"></a>

19 20
- **digit grouping**

sajolida's avatar
sajolida committed
21
  Use a non-breaking thin space (HTML entity: `&#8239;`) or a space to separate
22 23 24
  groups of three digits.

  * *For example*:
sajolida's avatar
sajolida committed
25
    - $50&#8239;000
26 27 28

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

30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
- **<i>Files</i>**, **<i>Disks</i>**, etc.

  To refer to GNOME applications:

  - Use their short name as it appears in the menus when giving
    instructions to be executed inside Tails.

    *For example*:
    - Open */live/persistence/TailsData_unlocked/dotfiles* in *Files*.

  - Prepend "*GNOME*" when giving instructions to be executed outside of
    Tails.

    *For example*:
    - Install GNOME Disks in Debian.
45

sajolida's avatar
sajolida committed
46 47
- **graphics card**

48 49
  And not *graphics adapters*, *graphics*, *graphical hardware*, or
  *video card*.
sajolida's avatar
sajolida committed
50

sajolida's avatar
sajolida committed
51 52 53 54 55 56
- **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.

57 58 59 60 61 62 63 64 65 66 67
- **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]]).

68 69 70 71 72 73
- **serial comma**

  Place a [[!wikipedia serial comma]] immediately before the
  coordinating conjunction (usually *and* or *or*) in a series of three
  or more terms.

sajolida's avatar
sajolida committed
74 75 76 77 78 79 80
- **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]].
81

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

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