[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 07/13] docs: simplify and clarify the platform support rules
From: |
Daniel P . Berrangé |
Subject: |
[PULL 07/13] docs: simplify and clarify the platform support rules |
Date: |
Fri, 29 Jan 2021 17:10:56 +0000 |
The distinction between short life and long life Linux distributions
turned out to be redundant. They can both be covered in a simple way
by noting support will target the current release, and the previous
release for a period of two years or until its EOL. This rule can also
apply to the other UNIX based distros, leaving only Windows needing a
different set of rules.
This also clarifies that Debian LTS is out of scope, because the LTS
support is provided by a separate group from the main Debian maintainer
team.
Reviewed-by: Eduardo Habkost <ehabkost@redhat.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
---
docs/system/build-platforms.rst | 63 ++++++++++++---------------------
1 file changed, 23 insertions(+), 40 deletions(-)
diff --git a/docs/system/build-platforms.rst b/docs/system/build-platforms.rst
index 9734eba2f1..692323609e 100644
--- a/docs/system/build-platforms.rst
+++ b/docs/system/build-platforms.rst
@@ -25,55 +25,38 @@ software in their distro, QEMU upstream code will not add
explicit
support for those backports, unless the feature is auto-detectable in a
manner that works for the upstream releases too.
-The Repology site https://repology.org is a useful resource to identify
+The `Repology`_ site is a useful resource to identify
currently shipped versions of software in various operating systems,
though it does not cover all distros listed below.
-Linux OS
---------
+Linux OS, macOS, FreeBSD, NetBSD, OpenBSD
+-----------------------------------------
-For distributions with frequent, short-lifetime releases, the project
-will aim to support all versions that are not end of life by their
-respective vendors. For the purposes of identifying supported software
-versions, the project will look at Fedora, Ubuntu, and openSUSE distros.
-Other short- lifetime distros will be assumed to ship similar software
-versions.
+The project aims to support the most recent major version at all times. Support
+for the previous major version will be dropped 2 years after the new major
+version is released or when the vendor itself drops support, whichever comes
+first. In this context, third-party efforts to extend the lifetime of a distro
+are not considered, even when they are endorsed by the vendor (eg. Debian LTS).
-For distributions with long-lifetime releases, the project will aim to
-support the most recent major version at all times. Support for the
-previous major version will be dropped 2 years after the new major
-version is released, or when it reaches "end of life". For the purposes
-of identifying supported software versions, the project will look at
-RHEL, Debian, Ubuntu LTS, and SLES distros. Other long-lifetime distros
-will be assumed to ship similar software versions.
+For the purposes of identifying supported software versions available on Linux,
+the project will look at CentOS, Debian, Fedora, openSUSE, RHEL, SLES and
+Ubuntu LTS. Other distros will be assumed to ship similar software versions.
-Windows
--------
-
-The project supports building with current versions of the MinGW
-toolchain, hosted on Linux.
-
-macOS
------
+For FreeBSD and OpenBSD, decisions will be made based on the contents of the
+respective ports repository, while NetBSD will use the pkgsrc repository.
-The project supports building with the two most recent versions of
-macOS, with the current Homebrew package set available.
+For macOS, `HomeBrew`_ will be used, although `MacPorts`_ is expected to carry
+similar versions.
-FreeBSD
+Windows
-------
-The project aims to support all versions which are not end of
-life.
-
-NetBSD
-------
+The project supports building with current versions of the MinGW toolchain,
+hosted on Linux (Debian/Fedora).
-The project aims to support the most recent major version at all times.
-Support for the previous major version will be dropped 2 years after the
-new major version is released.
-
-OpenBSD
--------
+The version of the Windows API that's currently targeted is Vista / Server
+2008.
-The project aims to support all versions which are not end of
-life.
+.. _HomeBrew: https://brew.sh/
+.. _MacPorts: https://www.macports.org/
+.. _Repology: https://repology.org/
--
2.29.2
- [PULL 00/13] Misc patches, Daniel P . Berrangé, 2021/01/29
- [PULL 02/13] crypto: Move USER_CREATABLE to secret_common base class, Daniel P . Berrangé, 2021/01/29
- [PULL 03/13] crypto: Forbid broken unloading of secrets, Daniel P . Berrangé, 2021/01/29
- [PULL 01/13] crypto: Fix some code style problems, add spaces around operator, Daniel P . Berrangé, 2021/01/29
- [PULL 04/13] crypto: Fix memory leaks in set_loaded for tls-*, Daniel P . Berrangé, 2021/01/29
- [PULL 05/13] os: deprecate the -enable-fips option and QEMU's FIPS enforcement, Daniel P . Berrangé, 2021/01/29
- [PULL 06/13] Prefer 'on' | 'off' over 'yes' | 'no' for bool options, Daniel P . Berrangé, 2021/01/29
- [PULL 07/13] docs: simplify and clarify the platform support rules,
Daniel P . Berrangé <=
- [PULL 08/13] docs: fix missing backslash in certtool shell example, Daniel P . Berrangé, 2021/01/29
- [PULL 09/13] configure: replace --enable/disable-git-update with --with-git-submodules, Daniel P . Berrangé, 2021/01/29
- [PULL 10/13] crypto: Add spaces around operator, Daniel P . Berrangé, 2021/01/29
- [PULL 11/13] ui: update keycodemapdb submodule commit, Daniel P . Berrangé, 2021/01/29
- [PULL 12/13] tests: Fix runtime error in test-authz-pam, Daniel P . Berrangé, 2021/01/29
- [PULL 13/13] tests: Replace deprecated ASN1 code, Daniel P . Berrangé, 2021/01/29
- Re: [PULL 00/13] Misc patches, no-reply, 2021/01/29
- Re: [PULL 00/13] Misc patches, Peter Maydell, 2021/01/29