Use fields markup to a better understanding

Author: parulin

user/reference/glossary.rst

@@ -9,25 +9,18 @@ Glossary
 
       - Currently, the only admin qube is :term:`dom0`.
 
-
-
    app qube
       Any :term:`qube` that does not have a root filesystem of its own. Every app qube is based on a :term:`template` from which it borrows the root filesystem.
 
-      - Previously known as: ``AppVM``, ``TemplateBasedVM``.
-
-      - Historical note: This term originally meant “a qube intended for running user software applications” (hence the name “app”).
-
-
+      :Previously known as: ``AppVM``, ``TemplateBasedVM``.
+      :Historical note: This term originally meant “a qube intended for running user software applications” (hence the name “app”).
 
    disposable
       A type of temporary :term:`app qube` that self-destructs when its originating window closes. Each disposable is based on a :term:`disposable template`.
 
-      See :doc:`/user/how-to-guides/how-to-use-disposables`.
-
-      - Previously known as: ``DisposableVM``, ``DispVM``.
-
+      :See: :doc:`/user/how-to-guides/how-to-use-disposables`.
 
+      :Previously known as: ``DisposableVM``, ``DispVM``.
 
    disposable template
       Any :term:`app qube` on which :term:`disposable` are based. A disposable template shares its user directories (and, indirectly, the root filesystem of the regular :term:`template` on which it is based) with all :term:`disposable` based on it.
@@ -40,42 +33,34 @@ Glossary
 
       - Unlike :term:`disposable`, disposable templates have the persistence properties of normal :term:`app qube`.
 
-      - Previously known as: ``DisposableVM Template``, ``DVM Template``, ``DVM``.
-
-
+      :Previously known as: ``DisposableVM Template``, ``DVM Template``, ``DVM``.
 
    dom0
       :term:`domain` zero. A type of :term:`admin qube`. Also known as the **host** domain, dom0 is the initial qube started by the Xen hypervisor on boot. Dom0 runs the Xen management toolstack and has special privileges relative to other domains, such as direct access to most hardware.
 
       - The term “dom0” is a common noun and should follow the capitalization rules of common nouns.
 
-
-
    domain
       In Xen, a synonym for :term:`vm`.
 
-      See `“domain” on the Xen Wiki <https://wiki.xenproject.org/wiki/Domain>`__.
+      :See: `“domain” on the Xen Wiki <https://wiki.xenproject.org/wiki/Domain>`__.
 
       - This term has no official meaning in Qubes OS.
 
-
-
    domU
       Unprivileged :term:`domain`. Also known as **guest** domains, domUs are the counterparts to dom0. In Xen, all VMs except dom0 are domUs. By default, most domUs lack direct hardware access.
 
       - The term “domU” is a common noun and should follow the capitalization rules of common nouns.
 
       - Sometimes the term :term:`vm` is used as a synonym for domU. This is technically inaccurate, as :term:`dom0` is also a VM in Xen.
 
-
-
    firmware
       Software that runs outside the control of the operating system. Some firmware executes on the same CPU cores as Qubes OS does, but all computers have many additional processors that the operating system does not run on, and these computers also run firmware.
 
    HVM
       Hardware-assisted Virtual Machine. Any fully virtualized, or hardware-assisted, :term:`vm` utilizing the virtualization extensions of the host CPU. Although HVMs are typically slower than paravirtualized qubes due to the required emulation, HVMs allow the user to create domains based on any operating system.
 
-      See :doc:`/user/advanced-topics/standalones-and-hvms`.
+      :See: :doc:`/user/advanced-topics/standalones-and-hvms`.
 
    management qube
       A :term:`qube` used for automated management of a Qubes OS installation via :doc:`/user/advanced-topics/salt`.
@@ -87,9 +72,7 @@ Glossary
 
       - Like a regular :term:`disposable`, a named disposable always has the same state when it starts, namely that of the :term:`disposable template` on which it is based.
 
-      - Technical note: Named disposables are useful for certain :term:`service qube`, where the combination of persistent device assignment and ephemeral qube state is desirable.
-
-
+      :Technical note: Named disposables are useful for certain :term:`service qube`, where the combination of persistent device assignment and ephemeral qube state is desirable.
 
    net qube
       Internally known as :term:`qube` that specifies from which qube, if any, it receives network access. Despite the name, “net qube” (or :term:`app qube` to be the :term:`service qube` ``sys-firewall``, which in turn uses ``sys-net`` as its net qube.
@@ -98,66 +81,55 @@ Glossary
 
       - The name :term:`service qube` called a “NetVM.” The name of the ``netvm`` property is a holdover from that era.
 
-
-
    policies
       In Qubes OS, “policies” govern interactions between qubes, powered by :doc:`Qubes’ qrexec system </developer/services/qrexec>`. A single policy is a rule applied to a qube or set of qubes, that governs how and when information or assets may be shared with other qubes.
       An example is the rules governing how files can be copied between qubes.
       Policy rules are grouped together in files under ``/etc/qubes/policy.d``
       Policies are an important part of what makes Qubes OS special.
 
-
    qube
       A secure compartment in Qubes OS. Currently, qubes are implemented as Xen :term:`vm`, but Qubes OS is independent of its underlying compartmentalization technology. VMs could be replaced with a different technology, and qubes would still be called “qubes.”
 
-      - **Important:** The term “qube” is a common noun and should follow the capitalization rules of common nouns. For example, “I have three qubes” is correct, while “I have three Qubes” is incorrect.
+      .. important:: The term “qube” is a common noun and should follow the capitalization rules of common nouns. For example, “I have three qubes” is correct, while “I have three Qubes” is incorrect.
 
       - Note that starting a sentence with the plural of “qube” (i.e., “Qubes…”) can be ambiguous, since it may not be clear whether the referent is a plurality of qubes or :term:`Qubes OS`.
 
       - Example usage: “In Qubes OS, you do your banking in your ‘banking’ qube and your web surfing in your ‘untrusted’ qube. That way, if your ‘untrusted’ qube is compromised, your banking activities will remain secure.”
 
       - Historical note: The term “qube” was originally invented as an alternative to “VM” intended to make it easier for less technical users to understand Qubes OS and learn how to use it.
 
-
-
    Qubes OS
       A security-oriented operating system (OS). The main principle of Qubes OS is security by compartmentalization (or isolation), in which activities are compartmentalized (or isolated) in separate :term:`qube`.
 
-      - **Important:** The official name is “Qubes OS” (note the capitalization and the space between “Qubes” and “OS”). In casual conversation, this is often shortened to “Qubes.” Only in technical contexts where spaces are not permitted (e.g., in usernames) may the space be omitted, as in ``@QubesOS``.
-
-
+      .. important:: The official name is “Qubes OS” (note the capitalization and the space between “Qubes” and “OS”). In casual conversation, this is often shortened to “Qubes.” Only in technical contexts where spaces are not permitted (e.g., in usernames) may the space be omitted, as in ``@QubesOS``.
 
    Qubes Windows Tools (QWT)
       A set of programs and drivers that provide integration of Windows qubes with the rest of the Qubes OS system.
 
-      See :doc:`/user/templates/windows/qubes-windows-tools` and :doc:`/user/templates/windows/qubes-windows`.
+      :See: :doc:`/user/templates/windows/qubes-windows-tools` and :doc:`/user/templates/windows/qubes-windows`.
 
    service qube
       Any :term:`app qube` the primary purpose of which is to provide services to other qubes. ``sys-net`` and ``sys-firewall`` are examples of service qubes.
 
    standalone
       Any :term:`qube` that has its own root filesystem and does not share it with another qube. Distinct from both :term:`template` and :term:`app qube`.
 
-      See :doc:`/user/advanced-topics/standalones-and-hvms`.
-
-      - Previously known as: ``StandaloneVM``.
-
-
+      :See: :doc:`/user/advanced-topics/standalones-and-hvms`.
+      :Previously known as: ``StandaloneVM``.
 
    template
       Any :term:`qube` that shares its root filesystem with another qube. A qube that is borrowing a template’s root filesystem is known as an :term:`app qube` and is said to be “based on” the template. Templates are intended for installing and updating software applications, but not for running them.
 
-      See :doc:`/user/templates/templates`.
+      :See: :doc:`/user/templates/templates`.
 
       - No template is an :term:`app qube`.
 
       - A template cannot be based on another template.
 
       - Regular templates cannot function as :term:`disposable template`. (Disposable templates must be app qubes.)
 
-      - Previously known as: ``TemplateVM``.
-
-
+      :See: :doc:`/user/templates/templates`.
+      :Previously known as: ``TemplateVM``.
 
    VM
       An abbreviation for “virtual machine.” A software implementation of a computer that provides the functionality of a physical machine.