From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <t.lamprecht@proxmox.com>
Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256)
 (No client certificate requested)
 by lists.proxmox.com (Postfix) with ESMTPS id DA4B4757C6
 for <pve-devel@lists.proxmox.com>; Thu, 14 Oct 2021 07:35:25 +0200 (CEST)
Received: from firstgate.proxmox.com (localhost [127.0.0.1])
 by firstgate.proxmox.com (Proxmox) with ESMTP id CC67718EFC
 for <pve-devel@lists.proxmox.com>; Thu, 14 Oct 2021 07:35:25 +0200 (CEST)
Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com
 [94.136.29.106])
 (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256)
 (No client certificate requested)
 by firstgate.proxmox.com (Proxmox) with ESMTPS id D77FF18EEE
 for <pve-devel@lists.proxmox.com>; Thu, 14 Oct 2021 07:35:24 +0200 (CEST)
Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1])
 by proxmox-new.maurer-it.com (Proxmox) with ESMTP id A651344BA7
 for <pve-devel@lists.proxmox.com>; Thu, 14 Oct 2021 07:35:24 +0200 (CEST)
Message-ID: <ae2b0fde-f96d-4621-84d2-7d74ce247abc@proxmox.com>
Date: Thu, 14 Oct 2021 07:35:23 +0200
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:94.0) Gecko/20100101
 Thunderbird/94.0
Content-Language: en-US
To: Proxmox VE development discussion <pve-devel@lists.proxmox.com>,
 Oguz Bektas <o.bektas@proxmox.com>
References: <20211013105904.781248-1-o.bektas@proxmox.com>
From: Thomas Lamprecht <t.lamprecht@proxmox.com>
In-Reply-To: <20211013105904.781248-1-o.bektas@proxmox.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
X-SPAM-LEVEL: Spam detection results:  0
 AWL 0.205 Adjusted score from AWL reputation of From: address
 BAYES_00                 -1.9 Bayes spam probability is 0 to 1%
 KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment
 NICE_REPLY_A           -0.001 Looks like a legit reply (A)
 SPF_HELO_NONE           0.001 SPF: HELO does not publish an SPF Record
 SPF_PASS               -0.001 SPF: sender matches SPF record
Subject: Re: [pve-devel] [PATCH docs] pct: add section for supported
 distributions
X-BeenThere: pve-devel@lists.proxmox.com
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Proxmox VE development discussion <pve-devel.lists.proxmox.com>
List-Unsubscribe: <https://lists.proxmox.com/cgi-bin/mailman/options/pve-devel>, 
 <mailto:pve-devel-request@lists.proxmox.com?subject=unsubscribe>
List-Archive: <http://lists.proxmox.com/pipermail/pve-devel/>
List-Post: <mailto:pve-devel@lists.proxmox.com>
List-Help: <mailto:pve-devel-request@lists.proxmox.com?subject=help>
List-Subscribe: <https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel>, 
 <mailto:pve-devel-request@lists.proxmox.com?subject=subscribe>
X-List-Received-Date: Thu, 14 Oct 2021 05:35:25 -0000

On 13.10.21 12:59, Oguz Bektas wrote:
> adds a simple section with a list of officially supported templates
> 
> Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
> ---
>  pct.adoc | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++-----
>  1 file changed, 70 insertions(+), 6 deletions(-)
> 
> diff --git a/pct.adoc b/pct.adoc
> index d01e6d7..1415f67 100644
> --- a/pct.adoc
> +++ b/pct.adoc
> @@ -84,13 +84,77 @@ Technology Overview
>  
>  * Modern Linux kernels
>  
> -* Image based deployment (templates)
> +* Image based deployment (xref:pct_supported_distributions[templates])
>  
>  * Uses {pve} xref:chapter_storage[storage library]
>  
>  * Container setup from host (network, DNS, storage, etc.)
>  
>  
> +[[pct_supported_distributions]]
> +Supported Distributions
> +~~~~~~~~~~~~~~~~~~~~~~~
> +
> +List of officially supported distributions can be found below.
> +
> +Templates for the following distributions are available through our
> +repositories. You can use xref:pct_container_images[pveam] tool or the
> +Graphical User Interface to download them.
> +
> +Alma Linux
> +^^^^^^^^^^
> +* Almalinux 8
> +

I'd throw Alma and Rocky into the section with CentOS, i.e.

CentOS, AlmaLinux, Rocky Linux
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

(AlmaLinux is spelled without a space)

> +Alpine Linux
> +^^^^^^^^^^^^

Can we add a small sentence describing the distro in short to readers and linking
to the project page here and for the other distro sections?

E.g., the quote from the alpine linux site:

"Alpine Linux is a security-oriented, lightweight Linux distribution based on musl libc and busybox."
-- https://alpinelinux.org/

> +* Alpine 3.12
> +* Alpine 3.13
> +* Alpine 3.14


Hmm, I'd maybe avoid the list of exact release, tends to be outdated to fast
for some.

Maybe we can link to the respective upstream release pages?

E.g.,
- https://alpinelinux.org/releases/
- https://wiki.ubuntu.com/Releases
- https://fedoraproject.org/wiki/Releases
- ...

> +
> +Archlinux
> +^^^^^^^^^
> +* Archlinux Base (20210420)
> +
> +CentOS
> +^^^^^^
> +* CentOS 7
> +* CentOS 8
> +
> +Debian
> +^^^^^^
> +* Debian 10 (Buster)
> +* Debian 11 (Bullseye)
> +
> +Devuan
> +^^^^^^
> +* Devuan 3.0
> +
> +Fedora
> +^^^^^^
> +* Fedora 33
> +* Fedora 34
> +
> +Gentoo
> +^^^^^^
> +* Gentoo Current (20200310)
> +
> +OpenSUSE
> +^^^^^^^^
> +* OpenSUSE 15.3
> +
> +Rocky Linux
> +^^^^^^^^^^^
> +* Rocky Linux 8
> +
> +Ubuntu
> +^^^^^^
> +* Ubuntu 16.04 (Xenial Xerus)
> +* Ubuntu 18.04 (Bionic Beaver)
> +* Ubuntu 20.04 (Focal Fossa)
> +* Ubuntu 21.04 (Hirsute Hippo)
> +* Ubuntu 21.10 (Impish Indri)
> +
> +
>  [[pct_container_images]]
>  Container Images
>  ----------------
> @@ -98,11 +162,11 @@ Container Images
>  Container images, sometimes also referred to as ``templates'' or
>  ``appliances'', are `tar` archives which contain everything to run a container.
>  
> -{pve} itself provides a variety of basic templates for the most common Linux
> -distributions. They can be downloaded using the GUI or the `pveam` (short for
> -{pve} Appliance Manager) command line utility.
> -Additionally, https://www.turnkeylinux.org/[TurnKey Linux] container templates
> -are also available to download.
> +{pve} itself provides a variety of basic templates for the
> +xref:pct_supported_distributions[most common Linuxdistributions].  They can be

"Linux distributions" needs a space in-between I'd figure?

> +downloaded using the GUI or the `pveam` (short for {pve} Appliance Manager)
> +command line utility.  Additionally, https://www.turnkeylinux.org/[TurnKey
> +Linux] container templates are also available to download.
>  
>  The list of available templates is updated daily through the 'pve-daily-update'
>  timer. You can also trigger an update manually by executing:
>