The `nomodeset` section needs some massaging due to the text flow being
broken a bit. While at it, link to it above at the 'Terminal UI'
bootloader tip such that readers can find it more easily.
Suggested-by: Alexander Zeidler <a.zeidler@proxmox.com>
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
The same changes were done in commit
4c35e536b ("installation: reword/expand/reflow and fix login thumbnail")
in pmg-docs to improve the layout as good as possible.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
These changes are the result of basically "diffing" both documentations,
choosing the better prased/sounding sections. Some wording were also
slightly changed as necessary to further improve them.
The equivalent changes will be done for pmg-docs too, to ensure they are
really the same in the end.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
These changes are the result of basically "diffing" both documentations,
choosing the better prased/sounding sections. Some wording were also
slightly changed as necessary to further improve them.
The equivalent changes will be done for pmg-docs too, to ensure they are
really the same in the end.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
New paragraphs were taken from pmg-docs and adapted. Most changes
here are the result of basically "diffing" both documentations, choosing
the better prased/sounding sections. Some wording were slightly changed
as necessary to further improve them.
The equivalent changes will be done for pmg-docs too, to ensure they are
really the same in the end.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
Some sentences are phrased better and more expansive in pmg-docs, so
take them from there and adapt them as needed.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
instead of the direct link to the latest ISO. As the wiki page contains
a bit more details about the VirtIO drivers and can be changed quickly
if needed.
Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
It's mostly spelled BTRFS anyway in our documentation (and also the
official casing AFAICS), so align a few instances where it spelled
lowercase.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
The `_ZFS_over_iSCSI` wiki page is redirected to the legacy page
(for historical reasons), but we want to link to the reference docs
instead.
for the wiki add the legacy link in a `see also` section, so users can
still reach that page easily should they need to
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
In the manpage output the sections get rendered as refsections, but
those only go up to level 3:
> In DocBook, RefSect3 is the lowest-level section allowed in a
> RefEntry. There is no element analogous to a Sect4.
-- https://tdg.docbook.org/tdg/4.5/refsect3
While nesting refsect3 would work output wise, the DTD schema does not
allows this, and disabling schema validation can lead to graver
issues, so rather avoid that and use a formalpara [0], a paragraph
with a title, instead, but only for the title, as the inner content
will be a simpara (simple paragraph) that cannot be nested inside a
formalpara, but the resulting rendering works out well enough.
[0]: https://tdg.docbook.org/tdg/4.5/formalpara
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Else h6 was quite a bit tinier than the actual paragraph text, and it
doesn't hurts that h4 stands a bit out more.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
E.g., render them as h6 for the HTML output.
Level 5 headings are the +++++ ones in the full page output, in the
per-chapter outputs they are level 4 and worked fine already.
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Also clarify in one example that using `--mailto` will bypass the
notification system (at least from the user's perspective).
Signed-off-by: Lukas Wagner <l.wagner@proxmox.com>
we could also add a check somewhere in pve-cluster for this.
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
[ TL: squash in changes Fiona proposed for the port syntax/wording ]
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
Especially for GRUB there were a myriad of different casing variants
(e.g. grub, Grub, GRUB), so unify them, with GRUB being the official
casing.
For systemd-boot, fix an instance where it was not typeset as
monospace, like everywhere else.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
As the grub entry specific to this was removed with the 8.1 release, add
a separate section for this to link users too.
Unfortunaly it is relatively often needed, due to very old or very new
hardware, or when Nvidia cards are installed.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
The 8.1 release changed some things, so update the screenshot to keep in
sync with the latest ISO.
Signed-off-by: Christoph Heiss <c.heiss@proxmox.com>
Following pve-storage commit 4abb327 ("plugin schema: improve
description of 'shared' property"), adapting the description also
here in the documentation.
It's not clear to users what this property does otherwise.
Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
by making that part bold. While there is already a big note where
cloudinit needs to be installed, it is after the actual command.
Making it more obvious right before the command will hopefully reduce
confusion for more users.
Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
