Commit 866a2e59 authored by sajolida's avatar sajolida
Browse files

Write style guide for the Persistent Storage

parent 44ed3255
......@@ -217,21 +217,70 @@
Still, **USB Wi-Fi adapters** are USB dongles that provide a Wi-Fi interface.
<a id="Persistent Storage"></a>
- **Persistent Storage**
And not *persistence* or *persistent volume*. Capitalize. Can be
introduced by *your*, *the*, *a* or no article depending on the
context.
The Persistent Storage refers to both the feature and the encrypted
volume on the USB stick.
In rare occasions, we write *encrypted Persistent Storage*, for
example when introducing the concept. Otherwise, we rely on the
interface of the Welcome Screen to remind people that it is encrypted.
The Persistent Storage is *created* using the Persistent Storage settings and
*unlocked* in the Welcome Screen.
*For example*:
- Create a Persistent Storage on your Tails USB stick.
- Enter your passphrase to unlock your Persistent Storage.
- Everything in the Persistent Storage is encrypted automatically.
- Add To Persistent Storage (button)
- **<em>Persistent</em> folder**
The folder */home/amnesia/Persistent/*.
*For example*:
- Save the database as `keepassx.kdbx` in the *Persistent* folder.
<a id="persistence-feature"></a>
- **persistence feature**
- **feature of the Persistent Storage**
And not *Persistent Storage feature*.
To refer to the features available in the configuration of the
*persistent storage*.
*Persistent Storage*.
- *For example*:
The construction *of the Persistent Storage* can be omitted if
redundant in the context, for example on
[[Create & configure the Persistent Storage|doc/first_steps/persistence/configure]].
- [&hellip;] when the [[<span class="guilabel">Additional Software</span>
persistence feature|doc/first_steps/persistence/configure#additional_software]]
is activated.
*For example*:
- To install additional software automatically when starting Tails, turn on
the [[Additional Software|doc/first_steps/persistence/configure#additional_software]]
feature of the Persistent Storage.
- **persistent** and **persist**
The property of something saved in the Persistent Storage and the act
of making something persistent. Use rarely.
*For example*:
The word *persistence* can be omitted if it is redundant from the context
(for example on [[doc/first_steps/persistence/configure]]).
- The Persistent Storage is optional and you always decide what is
persistent. Everything else is amnesic.
<a id="please"></a>
......
[[!meta robots="noindex"]]
Guidelines:
- "your Persistence" when referring to a volume that has already been
created on the USB stick, for example when unlocking it.
- "Persistence" (without article) the rest of the time, either when
referring to the feature or the volume itself.
- "the Persistence feature" when we need to refer to the feature
explicitly.
- "the Persistent folder" because it's its name in the file system.
- "GnuPG Persistence feature" for each of the options that can be
enabled in Persistence.
- "persistent" when referring to the property of something saved in
persistent.
Examples:
- Enter your passphrase to unlock your Persistence. (from Greeter)
- Your Persistence is unlocked. Restart Tails to lock it again. (from Greeter)
- Cannot delete the Persistence on %s while in use. (from Persistence setup)
- Upgrade your Tails USB stick and keep your Persistence. (from [[install/download]])
- This method might in rare occasions break the file system of your Persistence. (from [[doc/first_steps/shutdown]])
- Create an apt-sources.list.d folder in your Persistence. (from [[doc/first_steps/additional_software]])
- Freeing space in your Persistence. (from [[doc/first_steps/additional_software]])
- Follow these steps to create a new password database and save it in your Persistence for use in future working sessions. (from [[doc/encryption_and_privacy/manage_passwords]])
- When starting Tails, enable your Persistence. (from [[doc/encryption_and_privacy/manage_passwords]])
- If you choose [Install Every Time], the package is saved in your Persistence and will be reinstalled automatically every time you start Tails. (from [[doc/first_steps/additional_software]])
- Enable & use Persistence (from [[doc/first_steps/persistence]])
- Create Persistence (from [[install/win/usb]])
- You can create Persistence in the free space left on the USB stick. (from [[doc/first_steps/persistence]])
- Restart on your backup Tails and create Persistence on it. (from [[doc/first_steps/persistence/copy]])
- To create Persistence or change its configuration, choose Applications → Tails → Persistence. (from [[doc/first_steps/persistence/configure]])
- An attacker in possession of your USB stick can know that there is Persistence on it. (from [[doc/first_steps/persistence/warnings]])
- If Persistence is detected on the USB stick, an additional section appears in Tails Greeter. (from [[doc/first_steps/welcome_screen]])
- Warnings about Persistence (from [[doc/first_steps/persistence]])
- To understand better how Persistence works, see our design document. (from [[support/faq]])
- The simplest way to carry around the documents that you want to use with Tails encrypted is to use the Persistence feature. (from [[doc/encryption_and_privacy/encrypted_volumes]])
- To store your GnuPG keys and configuration across separate working sessions, you can activate the GnuPG Persistence feature. (from [[doc/encryption_and_privacy/gpgapplet/decrypt_verify]])
- Save the database as keepassx.kdbx in the Persistent folder. (from [[doc/encryption_and_privacy/manage_passwords]])
- Read the documentation on Persistence to learn which settings can be made persistent across separate working sessions. (from [[doc/first_steps/introduction_to_gnome_and_the_tails_desktop]])
[[!meta robots="noindex"]]
- Enter your passphrase to unlock your Persistent Storage. (from Greeter)
- Your Persistent Storage is unlocked. Restart Tails to lock it again. (from Greeter)
- Cannot delete the Persistent Storage on %s while in use. (from Persistence setup)
- Upgrade your Tails USB stick and keep your Persistent Storage. (from [[install/download]])
- This method might in rare occasions break the file system of your Persistent Storage. (from [[doc/first_steps/shutdown]])
- Create an apt-sources.list.d folder in your Persistent Storage. (from [[doc/first_steps/additional_software]])
- Freeing space in your Persistent Storage. (from [[doc/first_steps/additional_software]])
- Follow these steps to create a new password database and save it in your Persistent Storage for use in future working sessions. (from [[doc/encryption_and_privacy/manage_passwords]])
- When starting Tails, enable your Persistent Storage. (from [[doc/encryption_and_privacy/manage_passwords]])
- If you choose [Install Every Time], the package is saved in your Persistent Storage and will be reinstalled automatically every time you start Tails. (from [[doc/first_steps/additional_software]])
- Enable & use the Persistent Storage (from [[doc/first_steps/persistence]])
- Create the Persistent Storage (from [[install/win/usb]])
- You can create a Persistent Storage in the free space left on the USB stick. (from [[doc/first_steps/persistence]])
- Restart on your backup Tails and create the Persistent Storage on it. (from [[doc/first_steps/persistence/copy]])
- To create the Persistent Storage or change its configuration, choose Applications → Tails → Persistent Storage. (from [[doc/first_steps/persistence/configure]])
- An attacker in possession of your USB stick can know that there is a Persistent Storage on it. (from [[doc/first_steps/persistence/warnings]])
- If a Persistent Storage is detected on the USB stick, an additional section appears in Tails Greeter. (from [[doc/first_steps/welcome_screen]])
- Warnings about the Persistent Storage (from [[doc/first_steps/persistence]])
- To understand better how the Persistent Storage works, see our design document. (from [[support/faq]])
- The simplest way to carry around the documents that you want to use with Tails encrypted is to use the Persistent Storage. (from [[doc/encryption_and_privacy/encrypted_volumes]])
- To store your GnuPG keys and configuration across separate working sessions, you can activate the GnuPG feature of the Persistent Storage. (from [[doc/encryption_and_privacy/gpgapplet/decrypt_verify]])
- Save the database as keepassx.kdbx in the Persistent folder. (from [[doc/encryption_and_privacy/manage_passwords]])
- Read the documentation about the Persistent Storage to learn which settings can be made persistent across separate working sessions. (from [[doc/first_steps/introduction_to_gnome_and_the_tails_desktop]])
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment