git: 2f88ac36ff - main - Committer's Guide: four tiers: heading levels

From: Graham Perrin <grahamperrin_at_FreeBSD.org>
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.