From 256b6df89872d5e8df8ed7dc55933ceebf40b24f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Tue, 21 Oct 2025 16:03:32 +0200 Subject: [PATCH 1/5] GH-46002: [CI][Release] Define an official support policy --- docs/source/support.rst | 80 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 docs/source/support.rst diff --git a/docs/source/support.rst b/docs/source/support.rst new file mode 100644 index 000000000000..f51408a97dc0 --- /dev/null +++ b/docs/source/support.rst @@ -0,0 +1,80 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. _support: + +============== +Support Policy +============== + +Official Support Policy +======================= + +The Apache Arrow project houses a collection of libraries for different +programming languages supporting various build systems, operating systems and architectures. +This has generated a growing ecosystem of Continuous Integration (CI) jobs +to maintain in order to ensure the matrix of supported platforms is properly tested. + +This page documents how a platform (Operation System, architecture or build system) +is supported in Arrow along with a list of platforms that are currently supported for +the Arrow C++ implementation. + +Support tiers +============= + +Platform support is broken down into tiers. Each tier comes with different requirements +which lead to different promises being made about support. + +To be promoted to a tier, committer support is required and is expected to be driven by consensus. +A vote may be called if there is no agreement about the promotion but general consensus +on the GitHub issue is sufficient. + +Demotion to a lower tier occurs when a CI job is unmaintained for an extended period of time or the +platform is going to be EOLed. + +If the job is unmaintained a discussion on the mailing list and if necessary a vote +should be called in order to remove the platform from its current tier. + +When a Platform is EOLed, it should be demoted to Tier 3 immediately unless there is +a strong reason to keep it supported. + +Tier 1 +------ + - Is tested on CI on PRs or via periodic daily runs. + - Changes which would break the main branch are not allowed to be merged; any breakage should be fixed or reverted immediately. + - CI failures block releases. + - All committers are responsible to keep these CI jobs working. + +Tier 2 +------ + - Is tested on CI via periodic daily runs and can be tested on Pull Requests via optional jobs. + - The CI jobs are prefixed with ``Tier 2``. + - Are maintained as a best-effort basis. + - CI failures do not block releases. + - At least one committer should look over the CI jobs and be responsible to keep these platforms working. + +Tier 3 +------ + - Are not tested on CI. + - Unsupported though we might want to accept patches for them depending on the maintenance overhead. + + +.. list-table:: + :header-rows: 1 + + * - Platform constraint + - Tier From df85e13afbc9e095494947b2c9c523d10818f2f8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Wed, 22 Oct 2025 10:11:45 +0200 Subject: [PATCH 2/5] Move Support policy to cpp and update some references to Arrow C++ specifically --- docs/source/{ => developers/cpp}/support.rst | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) rename docs/source/{ => developers/cpp}/support.rst (82%) diff --git a/docs/source/support.rst b/docs/source/developers/cpp/support.rst similarity index 82% rename from docs/source/support.rst rename to docs/source/developers/cpp/support.rst index f51408a97dc0..2cfbfc73e954 100644 --- a/docs/source/support.rst +++ b/docs/source/developers/cpp/support.rst @@ -21,17 +21,16 @@ Support Policy ============== -Official Support Policy -======================= +Official Support Policy for Apache Arrow C++ +============================================ -The Apache Arrow project houses a collection of libraries for different -programming languages supporting various build systems, operating systems and architectures. -This has generated a growing ecosystem of Continuous Integration (CI) jobs -to maintain in order to ensure the matrix of supported platforms is properly tested. +The Apache Arrow C++ implementation supports various build systems, operating systems, +and architectures. This has generated a growing ecosystem of Continuous Integration (CI) +jobs to maintain in order to ensure the matrix of supported platforms is properly tested. -This page documents how a platform (Operation System, architecture or build system) -is supported in Arrow along with a list of platforms that are currently supported for -the Arrow C++ implementation. +This page documents how a platform (operation system, architecture or build system) +is supported in the Arrow C++ implementation along with a list of platforms that +are currently supported for the Arrow C++ implementation. Support tiers ============= From 6944f679048b5f2539f361efe29ecc64262421f4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 16 Nov 2026 14:23:37 +0100 Subject: [PATCH 3/5] Add several tables with Tiers --- docs/source/developers/cpp/support.rst | 152 ++++++++++++++++++++++++- 1 file changed, 151 insertions(+), 1 deletion(-) diff --git a/docs/source/developers/cpp/support.rst b/docs/source/developers/cpp/support.rst index 2cfbfc73e954..8fd68d046513 100644 --- a/docs/source/developers/cpp/support.rst +++ b/docs/source/developers/cpp/support.rst @@ -51,6 +51,10 @@ should be called in order to remove the platform from its current tier. When a Platform is EOLed, it should be demoted to Tier 3 immediately unless there is a strong reason to keep it supported. +Demotions other than for EOL should be announced on the mailing list early enough +for stakeholders to offer resources to keep the platform supported. +Each tier change should have its own GitHub issue and be recorded in the platform history below. + Tier 1 ------ - Is tested on CI on PRs or via periodic daily runs. @@ -71,9 +75,155 @@ Tier 3 - Are not tested on CI. - Unsupported though we might want to accept patches for them depending on the maintenance overhead. +Platform axes +============= + +A platform is described along independent axes: operating system, +architecture, compiler, SIMD level and build system. Each value on each +axis is assigned a tier. + +A given configuration is supported at the **lowest tier among its axes**. +For example, Linux (Tier 1) on s390x (Tier 3) is Tier 3. + +Tier 1 does not promise that every combination of Tier 1 values is tested. +It promises that every Tier 1 value is exercised by at least one Tier 1 CI +configuration. + +Operating systems +----------------- + +Only releases that are not end-of-life upstream are supported. When an +operating system release reaches its upstream end-of-life it is demoted to +Tier 3 unless there is a strong reason, and a committed maintainer, to keep +it supported. + +.. list-table:: + :header-rows: 1 + + * - Operating system + - Tier + - Notes + * - Ubuntu (LTS releases) + - 1 + - + * - Debian (stable releases) + - 1 + - + * - AlmaLinux, CentOS Stream, Amazon Linux + - 1 + - Covered by the binary packages, tested on a schedule + * - macOS + - 1 + - + * - Windows + - 1 + - + * - Alpine Linux (musl) + - 2 + - + * - Emscripten + - 2 + - + * - Any other + - 3 + - + +Architectures +------------- .. list-table:: :header-rows: 1 - * - Platform constraint + * - Architecture - Tier + - Notes + * - x86_64 (amd64) + - 1 + - Linux and Windows + * - aarch64 (arm64) + - 1 + - Linux and macOS + * - x86_64 (amd64) + - 2 + - macOS + * - aarch64 (arm64) + - 2 + - Windows + * - Any other (ppc64le, s390x, 32-bit, riscv64, ...) + - 3 + - + +Compilers +--------- + +.. list-table:: + :header-rows: 1 + + * - Compiler + - Tier + * - GCC 12 or newer + - 1 + * - Clang TODO or newer + - 1 + * - AppleClang (Xcode TODO or newer) + - 1 + * - MSVC (Visual Studio 2022 or newer) + - 1 + * - MinGW (MSYS2) + - 2 + +SIMD levels +----------- + +.. list-table:: + :header-rows: 1 + + * - SIMD level + - Tier + * - None (scalar fallback) + - 1 + * - SSE4.2 + - 1 + * - AVX2 + - 1 + * - NEON + - 1 + * - AVX512 + - 1 + * - SVE + - 1 + * - Any other + - 3 + +Build systems +------------- + +.. list-table:: + :header-rows: 1 + + * - Build system + - Tier + * - CMake + - 1 + * - Meson + - 2 + +Binary distribution +=================== + +The Linux packages (``.deb`` and ``.rpm``) published by the project for the +operating systems and architectures listed above are Tier 1. They are built +and tested on a scheduled basis rather than on every Pull Request. + +This policy does not cover Python wheels or other language bindings. + +Platform history +================ + +.. list-table:: + :header-rows: 1 + + * - Platform + - Change + - Arrow version + - Issue From 049bd5d17a573e14ffcec7aa838233cb3a4d4302 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 16 Nov 2026 14:35:17 +0100 Subject: [PATCH 4/5] Some versions from CI and notes --- docs/source/developers/cpp/support.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/source/developers/cpp/support.rst b/docs/source/developers/cpp/support.rst index 8fd68d046513..27700da7c852 100644 --- a/docs/source/developers/cpp/support.rst +++ b/docs/source/developers/cpp/support.rst @@ -163,9 +163,9 @@ Compilers - Tier * - GCC 12 or newer - 1 - * - Clang TODO or newer + * - Clang 18 or newer - 1 - * - AppleClang (Xcode TODO or newer) + * - AppleClang (Xcode version shipped by the oldest supported macOS) - 1 * - MSVC (Visual Studio 2022 or newer) - 1 @@ -190,7 +190,7 @@ SIMD levels - 1 * - AVX512 - 1 - * - SVE + * - SVE128 (Linux, runtime dispatch) - 1 * - Any other - 3 From d2925ab86705259b74b179b9373a9ebbce55d4d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ra=C3=BAl=20Cumplido?= Date: Mon, 16 Nov 2026 15:44:30 +0100 Subject: [PATCH 5/5] Add new page to index + some formatting fixes --- docs/source/developers/cpp/index.rst | 1 + docs/source/developers/cpp/support.rst | 29 ++++++++++++++++---------- 2 files changed, 19 insertions(+), 11 deletions(-) diff --git a/docs/source/developers/cpp/index.rst b/docs/source/developers/cpp/index.rst index b95cc69ea654..af7748fbcbb9 100644 --- a/docs/source/developers/cpp/index.rst +++ b/docs/source/developers/cpp/index.rst @@ -29,6 +29,7 @@ C++ Development windows emscripten conventions + support fuzzing compute acero diff --git a/docs/source/developers/cpp/support.rst b/docs/source/developers/cpp/support.rst index 27700da7c852..20a473db86e1 100644 --- a/docs/source/developers/cpp/support.rst +++ b/docs/source/developers/cpp/support.rst @@ -57,23 +57,26 @@ Each tier change should have its own GitHub issue and be recorded in the platfor Tier 1 ------ - - Is tested on CI on PRs or via periodic daily runs. - - Changes which would break the main branch are not allowed to be merged; any breakage should be fixed or reverted immediately. - - CI failures block releases. - - All committers are responsible to keep these CI jobs working. + +- Is tested on CI on PRs or via periodic daily runs. +- Changes which would break the main branch are not allowed to be merged; any breakage should be fixed or reverted immediately. +- CI failures block releases. +- All committers are responsible to keep these CI jobs working. Tier 2 ------ - - Is tested on CI via periodic daily runs and can be tested on Pull Requests via optional jobs. - - The CI jobs are prefixed with ``Tier 2``. - - Are maintained as a best-effort basis. - - CI failures do not block releases. - - At least one committer should look over the CI jobs and be responsible to keep these platforms working. + +- Is tested on CI via periodic daily runs and can be tested on Pull Requests via optional jobs. +- The CI jobs are prefixed with ``Tier 2``. +- Are maintained as a best-effort basis. +- CI failures do not block releases. +- At least one committer should look over the CI jobs and be responsible to keep these platforms working. Tier 3 ------ - - Are not tested on CI. - - Unsupported though we might want to accept patches for them depending on the maintenance overhead. + +- Are not tested on CI. +- Unsupported though we might want to accept patches for them depending on the maintenance overhead. Platform axes ============= @@ -227,3 +230,7 @@ Platform history - Change - Arrow version - Issue + * - macOS x86_64 + - Tier 1 to Tier 2 + - 27.0.0 + - `Mailing list discussion `__