From nobody Tue Aug 15 18:24:58 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4RQKSB697gz4qG6M for ; Tue, 15 Aug 2023 18:24:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4RQKSB5Z8Vz3JT5; Tue, 15 Aug 2023 18:24:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1692123898; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t06jNcXiVEL52inf/yCwL48059UKU5FZKRMJmzwyqwQ=; b=dU4P1bc6cLH2a7DKZvt1E1ETzsrbtZWb2RUKxfybILYJXFFXEs1bn5hayOgFKNtbsmY3fh 7Hpy9I5DKBIArNF4C1zHdwCcrA6OXl2dbCEvf4c2N2G2nB8HUj/XGRj8gvDF2q6hvhngST DLSJTDSyDrHZXiJywjYM90ny9zxNZi5+xlXbRW2H5STh6O67RbaNq5Ep7nk8EmNbQuSmmL t0eYO2lwSuDysRWqsID4TT7+gCky428WPGkWZmkicA8+m55cadyM2jSflygZ87XEwR0XZd 7XSNDRiEoqKYVaumsJxYUSpWfYDV+L+q2OnTQMasryKkVWklykpTcUINYln1Lg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1692123898; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=t06jNcXiVEL52inf/yCwL48059UKU5FZKRMJmzwyqwQ=; b=IAvQb7nD/4LgEGoV79DasWWIVZg23uCf4eQj42QfEhs4FFuWC8U1Uwwd01VqA7MRWb44sD K6FDVbuANQcuVyJOGtQtN5cdevn8n6QTIG5XUpjNUqaDieGCM9hM8I0Iu+p2Pm9ghdqvIJ vxAqR5kkYdXO9YaO6g7S1X/SzkpsZfxbl3zuu7J3Lc7lBxMXtlgpotHhFUaaq9hMTDjKxP aNq5ZGozvxicBd2erfBxUMZhNCkBqbf2lS3u+af/6hA50XyX0VU07nQcXhXbI9LHWHhxKr gVi6bTiO72pLtyOUkGaixB8xJgy8M6qkjb6scJUg8iiHZmzybuV42AYpHbXKMA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1692123898; a=rsa-sha256; cv=none; b=XnTbg57+MfxR5RN6kCICJoXixE71YlgVXEsSmXmvz6YV7AQ1vHNWZUGeJ68IeHoE8GhOQi Hagsk07B16+odPfFecB9t4Pq8YCo5IIHHrjS0Gh+DToXyftUEnaOTkfZ5aPrTxlm6qzCcO z8GB7emEI+TK8qGwBw5QLqBpfDtGWVgVSqwdhmD4o2C8EgadJ3ofsSUtBrC2Y4bFYoXTj2 9XdbuX06/mGLZzWXW49OChoR24ZsvGu9MHaS4Pi3YE0eSGoTywiMD64br53lsimuxHtrwk g9ZFQdKhp1y7qmMNqmznxsh3hdPintGk1nawqsQPqADUDnTk9dkPBsmRaoUixQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4RQKSB4PrDz5sP; Tue, 15 Aug 2023 18:24:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 37FIOwAd008491; Tue, 15 Aug 2023 18:24:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 37FIOwQe008488; Tue, 15 Aug 2023 18:24:58 GMT (envelope-from git) Date: Tue, 15 Aug 2023 18:24:58 GMT Message-Id: <202308151824.37FIOwQe008488@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: 2f88ac36ff - main - Committer's Guide: four tiers: heading levels List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 2f88ac36ffce99ad300ddbb7e481cef353a7c5c8 Auto-Submitted: auto-generated The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=2f88ac36ffce99ad300ddbb7e481cef353a7c5c8 commit 2f88ac36ffce99ad300ddbb7e481cef353a7c5c8 Author: Graham Perrin AuthorDate: 2023-08-15 18:19:21 +0000 Commit: Graham Perrin 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.