From patchwork Mon Nov 24 16:56:31 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 25165 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id A3F6AC32F1 for ; Mon, 24 Nov 2025 16:56:43 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id D019B60A7B; Mon, 24 Nov 2025 17:56:42 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="sP3QWYtL"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 4EC6B60AA1 for ; Mon, 24 Nov 2025 17:56:38 +0100 (CET) Received: from Monstersaurus.hippo-penny.ts.net (cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 1833D14B0; Mon, 24 Nov 2025 17:54:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1764003270; bh=JjnHX0CrTYdBMqNPTOeoWuz3hvQWM/9J0VHSTKHn1IU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=sP3QWYtLGTat7NktBxZXqKlrSirXn2ND8wFxr2/o5pz/ilXs88MAW18ieW76njjgq b+5H+B4tdN4p+bjxF0VG4aAbkSrtQZOSmTR5E2mbnG0degH9CHnZImgLVQ0B0OExQk HG/e2Xay2pH25qvwfhZOBrfKswCzxWelCny0Jluc= From: Kieran Bingham To: libcamera devel Cc: Kieran Bingham Subject: [PATCH 3/3] Documentation: contributing: Update Source references Date: Mon, 24 Nov 2025 16:56:31 +0000 Message-ID: <20251124165631.3040364-4-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.50.1 In-Reply-To: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> References: <20251124165631.3040364-1-kieran.bingham@ideasonboard.com> MIME-Version: 1.0 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" The libcamera project is no longer in 'early' stages of development, and we do make releases. Update the Source Code section to reflect this reality and report on the current expectations of release numbering schemes. Furthermore update the development mirror as hosted on Freedesktop and deprecate the LinuxTV mirror, as Freedesktop also hosts our release tar balls and CI infrastructure. Signed-off-by: Kieran Bingham Reviewed-by: Umang Jain --- Documentation/contributing.rst | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index fbe34a0184e6..495bfb3196b3 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -38,7 +38,26 @@ room: Source Code ----------- -libcamera is in early stages of development, and no releases are available yet. +libcamera is in active development, including investigations into what a 'good' +API is for the implementation. We can't guarantee we have all features +implemented, or designed correctly yet, and we have plans to make considerable +changes to the API and ABI in our roadmap. + +Even so, we provide periodic 'releases' to support distributions and packaging +teams. To support this we are currently making releases of the 0.y.z version +scheme, loosely following semver. + +In the foreseeable future, the following applies: + + 0.y.z : Active development, but with ABI breakage detection. The 0.y + version will bump on an ABI/API breakage. Ongoing development will + increment the .z version component. Therefore, pre 1.0 'y' is a + close equivalent to a major release. + + 1.y.z : Stable API and ABI guarantees on the Major version number. + Following semantic versioning as documented at https://semver.org/ + + The source code is available from the project's `git tree`_. .. code-block:: shell @@ -47,9 +66,13 @@ The source code is available from the project's `git tree`_. .. _git tree: https://git.libcamera.org/libcamera/libcamera.git/ -A mirror is also hosted on `LinuxTV`_. +A development mirror is also hosted on `Freedesktop`_. -.. _LinuxTV: https://git.linuxtv.org/libcamera.git/ +.. _Freedesktop: https://gitlab.freedesktop.org/camera/libcamera + +Freedesktop also provides our CI and `testing pipeline`_. + +.. _testing pipeline: https://gitlab.freedesktop.org/camera/libcamera/-/pipelines Issue Tracker -------------