From a4dd000030e9d97921b282cddf7c018f37062a1d Mon Sep 17 00:00:00 2001 From: parulin <161326115+parulin@users.noreply.github.com> Date: Wed, 17 Sep 2025 07:55:44 -0400 Subject: [PATCH 1/2] Introduction: markup changes Following the doc migration from Markdown to RestructuredText, a more logical markup was applied to the *Features* section, but not to the section about *video tours*, *screenshots* and *Getting started*. I changed that last section and ended up using a definition list also for the Features section (seems more consistent and appropriate as links are allowed in titles. The `figure` markup should be used for images with a caption or a description** --- introduction/intro.rst | 105 +++++++++++++++-------------------------- 1 file changed, 39 insertions(+), 66 deletions(-) diff --git a/introduction/intro.rst b/introduction/intro.rst index 4b70a70b..7084a12a 100644 --- a/introduction/intro.rst +++ b/introduction/intro.rst @@ -11,70 +11,60 @@ What is Qubes OS? ----------------- Qubes OS is a free and open-source, security-oriented operating system for -single-user desktop computing. Qubes OS `leverages Xen-based virtualization `__ to allow for the creation and management of isolated compartments called :term:`qubes `. +single-user desktop computing. Qubes OS leverages `Xen-based virtualization `__ to allow for the creation and management of isolated compartments called :term:`qubes `. +These qubes, which are implemented as :term:`virtual machines (VMs) `, have specific: -These qubes, which are implemented as :ref:`virtual machines (VMs)`, have specific: - -- **Purposes:** with a predefined set of one or many isolated - applications, for personal or professional projects, to manage the - :doc:`network stack `, :doc:`the firewall `, or to fulfill other - user-defined purposes. +- **Purposes:** with a predefined set of one or many isolated applications, for personal or professional projects, to manage the :doc:`network stack `, :doc:`the firewall `, or to fulfill other user-defined purposes. -- **Natures:** :doc:`full-fledged ` or - :doc:`stripped-down ` virtual machines based on popular operating systems, - such as :doc:`Fedora `, :doc:`Debian `, and - :doc:`Windows `. - -- **Levels of trust:** from complete to non-existent. All windows are displayed in a unified desktop environment with - :doc:`unforgeable colored window borders ` so that different security levels are easily identifiable. +- **Natures:** :doc:`full-fledged ` or :doc:`stripped-down ` virtual machines based on popular operating systems, such as :doc:`Fedora `, :doc:`Debian `, and :doc:`Windows `. -.. figure:: /attachment/site/qubes-trust-level-architecture.png +- **Levels of trust:** from complete to non-existent. All windows are displayed in a unified desktop environment with :doc:`unforgeable colored window borders ` so that different security levels are easily identifiable. + +.. image:: /attachment/site/qubes-trust-level-architecture.png :alt: Qubes system diagram - .. note:: - **Note:** See our :doc:`glossary ` and :doc:`FAQ ` for more information. - + See our :doc:`/user/reference/glossary` and :doc:`/introduction/faq` for more information. Features -------- -- **Strong isolation** Isolate different pieces of software as if they were installed on separate - physical machines using advanced virtualization techniques. +Strong isolation + Isolate different pieces of software as if they were installed on separate physical machines using advanced virtualization techniques. -- **Template system** Use :term:`app qubes ` to - share a root file system without sacrificing security using the innovative - :doc:`Template system `. +Template system + Use :term:`app qubes ` to share a root file system without sacrificing security using the innovative :doc:`Template system `. +Multiple operating systems + Use multiple operating systems at the same time, including :doc:`Fedora `, :doc:`Debian `, and :doc:`Windows ` -- **Multiple operating systems** Use multiple operating systems at the same time, including - :doc:`Fedora `, :doc:`Debian `, and - :doc:`Windows ` +:term:`Disposables ` + Create :doc:`disposables ` on the fly that self-destruct when shut down. -- **Disposables** Create :doc:`disposables ` on the fly that self-destruct when shut down. +Whonix integration + Run `Tor `__ securely system-wide using `Whonix with Qubes `__. -- **Whonix integration** Run `Tor `__ securely system-wide using `Whonix with Qubes `__. +Device isolation + Secure :doc:`device handling ` through isolation of network cards and USB controllers. -- **Device isolation** Secure :doc:`device handling ` through isolation of network cards and USB controllers. +Split GPG + Utilize :doc:`Split GPG ` to keep your private keys safe. -- **Split GPG** Utilize :doc:`Split GPG ` to keep your private keys safe. - -- **CTAP proxy** Operate :doc:`Qubes CTAP proxy ` to use your two-factor authentication devices without exposing your web browser to the full USB stack. - -- **Open-source** Users are free to use, copy, and modify Qubes OS and :doc:`are encouraged to do so! ` +CTAP proxy + Operate :doc:`Qubes CTAP proxy ` to use your two-factor authentication devices without exposing your web browser to the full USB stack. +Open-source + Users are free to use, copy, and modify Qubes OS and :doc:`are encouraged to do so! ` .. note:: - **Note:** Given the technical nature of Qubes OS, prior experience with Linux can be helpful. - + Given the technical nature of Qubes OS, prior experience with Linux can be helpful. Why Qubes OS? ------------- - Physical isolation is a given safeguard that the digital world lacks ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -95,11 +85,9 @@ Better yet, it allows us to create new compartments whenever we need them, and it gives us sophisticated tools for securely managing our activities and data across these compartments. -.. figure:: /attachment/doc/r4.0-qubes-manager.png +.. image:: /attachment/doc/r4.0-qubes-manager.png :alt: Qubes manager - - Qubes allows you to compartmentalize your digital life ------------------------------------------------------ @@ -126,13 +114,12 @@ physical computer without having to worry about a single successful cyberattack taking down your entire digital life in one fell swoop. In fact, Qubes has `distinct advantages over physical air gaps `__. -.. figure:: /attachment/site/qubes-partition-data-flows.jpg +.. image:: /attachment/site/qubes-partition-data-flows.jpg :alt: Compartmentalization example Made to support vulnerable users and power users alike ------------------------------------------------------ - Qubes provides practical, usable security to vulnerable and actively-targeted individuals, such as journalists, activists, whistleblowers, and researchers. Qubes is designed with the understanding @@ -157,31 +144,18 @@ software, because the fundamental operating system that constitutes the core infrastructure of our digital lives **must** be free and open-source in order to be trustworthy. - -.. figure:: /attachment/doc/r4.0-snapshot12.png +.. image:: /attachment/doc/r4.0-snapshot12.png :alt: Qubes desktop screenshot +Qubes OS at a glance +-------------------- - -Video Tours -^^^^^^^^^^^ - -Want to see Qubes OS in action? Sit back and watch a guided :doc:`tour! ` - - -Screenshots -^^^^^^^^^^^ - -See what using Qubes actually looks like with these :doc:`screenshots ` of various -applications running in Qubes. - - -Getting Started -^^^^^^^^^^^^^^^ - -Ready to get started with Qubes? :doc:`Here's ` what you need to know after installing. - - +:doc:`/introduction/video-tours/` + Want to see Qubes OS in action? Sit back and watch one of the guided tour! +:doc:`/introduction/screenshots/` + See what using Qubes actually looks like with various applications running in Qubes. +:doc:`/introduction/getting-started` + Ready to get started with Qubes? Find all you need to know after installing. More information ---------------- @@ -190,9 +164,8 @@ This page is just a brief introduction to what Qubes is all about, and many technical details have been omitted here for the sake of presentation. - - If you’re a current or potential Qubes user, you may want to check out the :doc:`documentation ` and the :ref:`user FAQ `. -- If you’re a developer, there’s dedicated :ref:`index:Developer Documentation` and a :ref:`developer FAQ ` just for you. +- If you’re a developer, there’s dedicated :ref:`index:Developer Documentation`, a :ref:`developer FAQ ` and the `documentation of the source code `__, just for you. - Ready to give Qubes a try? Head on over to the `downloads page `__, and read the :doc:`Installation guide `. - Need help, or just want to join the conversation? Learn more about :doc:`help, support, the mailing lists, and the forum `. From cfffa34a43b06e86a22d10a0a3325d8dfd244db2 Mon Sep 17 00:00:00 2001 From: parulin <161326115+parulin@users.noreply.github.com> Date: Sun, 21 Sep 2025 11:43:52 -0400 Subject: [PATCH 2/2] Revert some links in intro Revert some links introduced or removed in a4dd0000 --- introduction/intro.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/introduction/intro.rst b/introduction/intro.rst index c10ed7e4..2a5e4168 100644 --- a/introduction/intro.rst +++ b/introduction/intro.rst @@ -151,7 +151,7 @@ Qubes OS at a glance -------------------- :doc:`/introduction/video-tours/` - Want to see Qubes OS in action? Sit back and watch one of the guided tour! + Want to see Qubes OS in action? Sit back and watch one of the guided :doc:`/introduction/video-tours/`! :doc:`/introduction/screenshots/` See what using Qubes actually looks like with various applications running in Qubes. :doc:`/introduction/getting-started` @@ -165,7 +165,7 @@ many technical details have been omitted here for the sake of presentation. - If you’re a current or potential Qubes user, you may want to check out the :doc:`documentation ` and the :ref:`user FAQ `. -- If you’re a developer, there’s dedicated :ref:`index:Developer Documentation`, a :ref:`developer FAQ ` and the `documentation of the source code `__, just for you. +- If you’re a developer, there’s dedicated :ref:`index:Developer Documentation` and a :ref:`developer FAQ ` just for you. - Ready to give Qubes a try? Head on over to the `downloads page `__, and read the :doc:`Installation guide `. - Need help, or just want to join the conversation? Learn more about :doc:`help, support, the mailing lists, and the forum `.