With duplication, inconsistencies appears, such as:
- Poetry did not have a version check of sphinx-build;
- Poetry did not discern between git clone and fetching other
dependencies;
- Virtual environment and poetry documentation were different already;
- Build instructions sometimes used "qubes-doc" or "../qubes-doc".
New structure introduces sections to separate installation, lint and
build process.
* The Device Widget icon is updated, taken from
[qubes-desktop-linux-manager](QubesOS/qubes-desktop-linux-manager/tree/release4.2/)
* As the original PNG was deleted, all the ``how-to-use-*-devices`` have
been updated too (with a better markup)
* QubesOS/qubes-issues#4692 is closed so the corresponding paragraph has
been removed.
Note: cherry-picked from #1492
* windows-qubes-4-X redirect to qubes-windows
* qubes-windows-tools-4-X redirect to qubes-windows-tools
* migrate-to-4-1 redirect to qubes-windows-migrate
Should fixQubesOS/qubes-issues#10234
- use proper directives (warning, etc.) and roles (samp, menuselection)
- convert an image to a figure with description
- remove useless alt attributes
- proper links (no click here) + fix redirections
- better prompts
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**
Fix the "reStrucutredText" words. That's a good example on why it is
better not to label link when possible :)
There is other minor typos and inconsitencies (RST instead of rST).
