git: 2f88ac36ff - main - Committer's Guide: four tiers: heading levels
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 15 Aug 2023 18:24:58 UTC
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.