Re: [pve-devel] [PATCH docs 3/7] installation: revise introduction

["Shannon Sterz" <s.sterz@proxmox.com>]

On Tue Mar 4, 2025 at 4:40 PM CET, Alexander Zeidler wrote:
> * Mention all currently available install options and link to them
>   (interactive installer, unattended, on top of Debian)
> * Remove installer details and link to the installer, where the
>   information will be included by a subsequent patch (
>   "installer: revise introduction").
>
> Signed-off-by: Alexander Zeidler <a.zeidler@proxmox.com>
> ---
>  pve-installation.adoc | 30 +++++++++++++++++-------------
>  1 file changed, 17 insertions(+), 13 deletions(-)
>
> diff --git a/pve-installation.adoc b/pve-installation.adoc
> index d320cfc..0065bca 100644
> --- a/pve-installation.adoc
> +++ b/pve-installation.adoc
> @@ -8,22 +8,24 @@ ifdef::wiki[]
>  :title: Installation
>  endif::wiki[]
>
> -{pve} is based on Debian. This is why the install disk images (ISO files)
> -provided by Proxmox include a complete Debian system as well as all necessary
> -{pve} packages.
> +Since {pve} is based on Debian GNU/Linux, the installer ISO files
> +provided by Proxmox include a complete Debian system as well as all
> +necessary {pve} packages.
>
> -TIP: See the xref:faq-support-table[support table in the FAQ] for the
> -relationship between {pve} releases and Debian releases.
> +{pve} can be installed via different methods:
>
> -The installer will guide you through the setup, allowing you to partition the
> -local disk(s), apply basic system configurations (for example, timezone,
> -language, network) and install all required packages. This process should not
> -take more than a few minutes. Installing with the provided ISO is the
> -recommended method for new and existing users.
> +* The recommended method is the creation of an

The recommended method is to create an..

would sound a bit less "biblical" to me ;)

> +xref:installation_prepare_media[installation medium], to boot the
> +convenient xref:installation_installer[interactive installer].
>
> -Alternatively, {pve} can be installed on top of an existing Debian system. This
> -option is only recommended for advanced users because detailed knowledge about
> -{pve} is required.
> +* As an alternative to the interactive installer, advanced users may
> +wish to xref:installation_unattended[install {pve} unattended].
> +
> +* With sufficient Debian and {pve} knowledge, you can also
> +xref:installation_on_debian[install {pve} on top of Debian] manually.
> +
> +TIP: See the xref:faq-support-table[support table in the FAQ] for the
> +relationship between {pve} releases and Debian releases.
>
>  ifndef::wiki[]
>
> @@ -427,6 +429,8 @@ after a 10-second timeout.
>  https://pve.proxmox.com/wiki/Automated_Installation[Visit our wiki] for more
>  details and information on the unattended installation.
>
> +[[installation_on_debian]]
> +
>  ifndef::wiki[]
>
>  Install {pve} on Debian



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel