[pve-devel] [PATCH v2 docs] pct: add section for supported distributions

[pve-devel] [PATCH v2 docs] pct: add section for supported distributions

[Oguz Bektas]

adds a simple section with a list of officially supported distributions

Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
---
v1->v2:
* removed list of releases, instead put link to releases page for distro (if it exists)
* added simple descriptions from respective websites of distros
* put centos and derivatives into single heading


 pct.adoc | 125 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 119 insertions(+), 6 deletions(-)

diff --git a/pct.adoc b/pct.adoc
index d01e6d7..b504249 100644
--- a/pct.adoc
+++ b/pct.adoc
@@ -84,13 +84,126 @@ 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.
+
+Alpine Linux
+^^^^^^^^^^^^
+
+"Alpine Linux is a security-oriented, lightweight Linux distribution based on
+musl libc and busybox."
+
+https://alpinelinux.org
+
+https://alpinelinux.org/releases/
+
+Archlinux
+^^^^^^^^^
+
+"a lightweight and flexible Linux® distribution that tries to Keep It Simple."
+
+https://wiki.archlinux.org/title/Arch_Linux
+
+
+CentOS, Almalinux, Rocky Linux
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+__CentOS__: "The CentOS Linux distribution is a stable, predictable, manageable and
+reproducible platform derived from the sources of Red Hat Enterprise Linux
+(RHEL)"
+
+https://centos.org
+
+https://wiki.centos.org/About/Product
+
+__Almalinux__: "An Open Source, community owned and governed, forever-free
+enterprise Linux distribution, focused on long-term stability, providing a
+robust production-grade platform. AlmaLinux OS is 1:1 binary compatible with
+RHEL® and pre-Stream CentOS."
+
+https://almalinux.org
+
+https://en.wikipedia.org/wiki/AlmaLinux#Releases
+
+__Rocky Linux__: "Rocky Linux is a community enterprise operating system designed
+to be 100% bug-for-bug compatible with America's top enterprise Linux
+distribution now that its downstream partner has shifted direction."
+
+https://rockylinux.org/
+
+https://en.wikipedia.org/wiki/Rocky_Linux#Releases
+
+
+Debian
+^^^^^^
+
+"Debian is a free operating system, developed and maintained by the Debian
+project. A free Linux distribution with thousands of applications to meet our
+users' needs."
+
+https://www.debian.org/intro/index#software
+
+https://www.debian.org/releases/stable/releasenotes
+
+Devuan
+^^^^^^
+
+"Devuan GNU+Linux is a fork of Debian without systemd that allows users to
+reclaim control over their system by avoiding unnecessary entanglements and
+ensuring Init Freedom."
+
+https://www.devuan.org
+
+Fedora
+^^^^^^
+
+"Fedora creates an innovative, free, and open source platform for hardware,
+clouds, and containers that enables software developers and community members
+to build tailored solutions for their users."
+
+https://getfedora.org
+
+https://fedoraproject.org/wiki/Releases
+
+Gentoo
+^^^^^^
+
+"a highly flexible, source-based Linux distribution."
+
+https://www.gentoo.org
+
+OpenSUSE
+^^^^^^^^
+
+"The makers' choice for sysadmins, developers and desktop users."
+
+https://www.opensuse.org
+
+https://get.opensuse.org/leap/
+
+Ubuntu
+^^^^^^
+
+"The world’s most popular Linux for desktop computing."
+
+https://docs.ubuntu.com/
+
+https://wiki.ubuntu.com/Releases
+
 [[pct_container_images]]
 Container Images
 ----------------
@@ -98,11 +211,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 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.
 
 The list of available templates is updated daily through the 'pve-daily-update'
 timer. You can also trigger an update manually by executing:
-- 
2.30.2

Re: [pve-devel] [PATCH v2 docs] pct: add section for supported distributions

[Oguz Bektas]

any news for this?

On Thu, Oct 14, 2021 at 10:19:16AM +0200, Oguz Bektas wrote:
> adds a simple section with a list of officially supported distributions
> 
> Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
> ---
> v1->v2:
> * removed list of releases, instead put link to releases page for distro (if it exists)
> * added simple descriptions from respective websites of distros
> * put centos and derivatives into single heading
> 
> 
>  pct.adoc | 125 ++++++++++++++++++++++++++++++++++++++++++++++++++++---
>  1 file changed, 119 insertions(+), 6 deletions(-)
> 

Re: [pve-devel] [PATCH v2 docs] pct: add section for supported distributions

[Thomas Lamprecht]

On 02.11.21 15:18, Oguz Bektas wrote:
> any news for this?
>
not really, but not using asciidoc syntax for quotes was a reason that prevented me from applying it.

Re: [pve-devel] [PATCH v2 docs] pct: add section for supported distributions

[Oguz Bektas]

On Thu, Nov 04, 2021 at 12:00:03PM +0100, Thomas Lamprecht wrote:
> On 02.11.21 15:18, Oguz Bektas wrote:
> > any news for this?
> >
> not really, but not using asciidoc syntax for quotes was a reason that prevented me from applying it.

which syntax exactly?

if i do it like this:

"a lightweight and flexible Linux® distribution that tries to Keep It
Simple." -- https://wiki.archlinux.org/title/Arch_Linux

it breaks the link in the rendered HTML page (it's not
highlighted or clickable). thats why i separated the links.

or do you mean something else?

Re: [pve-devel] [PATCH v2 docs] pct: add section for supported distributions

[Thomas Lamprecht]

On 04.11.21 12:12, Oguz Bektas wrote:
> On Thu, Nov 04, 2021 at 12:00:03PM +0100, Thomas Lamprecht wrote:
>> On 02.11.21 15:18, Oguz Bektas wrote:
>>> any news for this?
>>>
>> not really, but not using asciidoc syntax for quotes was a reason that prevented me from applying it.
> 
> which syntax exactly?
> 
> if i do it like this:
> 
> "a lightweight and flexible Linux® distribution that tries to Keep It
> Simple." -- https://wiki.archlinux.org/title/Arch_Linux
> 
> it breaks the link in the rendered HTML page (it's not
> highlighted or clickable). thats why i separated the links.
> 
> or do you mean something else?

well, either
- grep quote *.adoc
- https://letmegooglethat.com/?q=asciidoc+quote
get me some examples for quote syntax ;P

E.g.:

[quote, https://wiki.archlinux.org/title/Arch_Linux]
____
a lightweight and flexible Linux® distribution that tries to Keep It Simple
____