Date: Tue, 15 Aug 2023 18:24:58 GMT From: Graham Perrin <grahamperrin@FreeBSD.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org Subject: git: 2f88ac36ff - main - Committer's Guide: four tiers: heading levels Message-ID: <202308151824.37FIOwQe008488@gitrepo.freebsd.org>
next in thread | raw e-mail | index | archive | help
The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=2f88ac36ffce99ad300ddbb7e481cef353a7c5c8 commit 2f88ac36ffce99ad300ddbb7e481cef353a7c5c8 Author: Graham Perrin <grahamperrin@FreeBSD.org> AuthorDate: 2023-08-15 18:19:21 +0000 Commit: Graham Perrin <grahamperrin@FreeBSD.org> CommitDate: 2023-08-15 18:19:21 +0000 Committer's Guide: four tiers: heading levels https://docs.freebsd.org/en/articles/committers-guide/#_statement_of_general_intent Level 3 section title for tiers 1, 2, and 3, and for the unsupported tier. Reviewed-by: imp Approved-by: emaste Pull-request: https://github.com/freebsd/freebsd-doc/pull/188 Closes: https://github.com/freebsd/freebsd-doc/pull/188 --- documentation/content/en/articles/committers-guide/_index.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/articles/committers-guide/_index.adoc b/documentation/content/en/articles/committers-guide/_index.adoc index 8ab5fe1142..4310f234f8 100644 --- a/documentation/content/en/articles/committers-guide/_index.adoc +++ b/documentation/content/en/articles/committers-guide/_index.adoc @@ -3286,7 +3286,7 @@ The native "ABI" generally shares certain properties with the kernel ABI such as Tiers are defined for both kernels and userland ABIs. In the common case, a platform's kernel and FreeBSD ABIs are assigned to the same tier. -=== Tier 1: Fully-Supported Architectures +==== Tier 1: Fully-Supported Architectures Tier 1 platforms are the most mature FreeBSD platforms. They are supported by the security officer, release engineering, and Ports Management Team. @@ -3322,7 +3322,7 @@ Collectively, developers are required to provide the following to maintain the T * Changes cannot break the userland ABI. If an ABI change is required, ABI compatibility for existing binaries should be provided via use of symbol versioning or shared library version bumps. * Changes merged to stable branches cannot break the protected portions of the kernel ABI. If a kernel ABI change is required, the change should be modified to preserve functionality of existing kernel modules. -=== Tier 2: Developmental and Niche Architectures +==== Tier 2: Developmental and Niche Architectures Tier 2 platforms are functional, but less mature FreeBSD platforms. They are not supported by the security officer, release engineering, and Ports Management Team. @@ -3350,7 +3350,7 @@ Collectively, developers are required to provide the following to maintain the T * While changes are permitted to break the userland ABI, the ABI should not be broken gratuitously. Significant userland ABI changes should be restricted to major versions. * New features that are not yet implemented on Tier 2 architectures should provide a means of disabling them on those architectures. -=== Tier 3: Experimental Architectures +==== Tier 3: Experimental Architectures Tier 3 platforms have at least partial FreeBSD support. They are _not_ supported by the security officer, release engineering, and Ports Management Team. @@ -3361,7 +3361,7 @@ Initial support for Tier 3 platforms may exist in a separate repository rather t The FreeBSD Project provides no guarantees to consumers of Tier 3 platforms and is not committed to maintaining resources to support development. Tier 3 platforms may not always be buildable, nor are any kernel or userland ABIs considered stable. -=== Unsupported Architectures +==== Unsupported Architectures Other platforms are not supported in any form by the project. The project previously described these as Tier 4 systems.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202308151824.37FIOwQe008488>