[{"id":37041,"web_url":"https://patchwork.libcamera.org/comment/37041/","msgid":"<912096ed11cf804ad27399ba57afc253@igalia.com>","date":"2025-11-25T05:31:10","subject":"Re: [PATCH 3/3] Documentation: contributing: Update Source\n\treferences","submitter":{"id":232,"url":"https://patchwork.libcamera.org/api/people/232/","name":"Umang Jain","email":"uajain@igalia.com"},"content":"On 2025-11-24 22:26, Kieran Bingham wrote:\n> The libcamera project is no longer in 'early' stages of development, and\n> we do make releases.\n> \n> Update the Source Code section to reflect this reality and report on the\n> current expectations of release numbering schemes.\n> \n> Furthermore update the development mirror as hosted on Freedesktop and\n> deprecate the LinuxTV mirror, as Freedesktop also hosts our release tar\n> balls and CI infrastructure.\n> \n> Signed-off-by: Kieran Bingham \n\nReviewed-by: Umang Jain \n> ---\n> Documentation/contributing.rst | 29 ++++++++++++++++++++++++++---\n> 1 file changed, 26 insertions(+), 3 deletions(-)\n> \n> diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst\n> index fbe34a0184e6..495bfb3196b3 100644\n> --- a/Documentation/contributing.rst\n> +++ b/Documentation/contributing.rst\n> @@ -38,7 +38,26 @@ room:\n> Source Code\n> -----------\n> \n> -libcamera is in early stages of development, and no releases are available yet.\n> +libcamera is in active development, including investigations into what a 'good'\n> +API is for the implementation. We can't guarantee we have all features\n> +implemented, or designed correctly yet, and we have plans to make considerable\n> +changes to the API and ABI in our roadmap.\n> +\n> +Even so, we provide periodic 'releases' to support distributions and packaging\n> +teams. To support this we are currently making releases of the 0.y.z version\n> +scheme, loosely following semver.\n> +\n> +In the foreseeable future, the following applies:\n> +\n> + 0.y.z : Active development, but with ABI breakage detection. The 0.y\n> + version will bump on an ABI/API breakage. Ongoing development will\n> + increment the .z version component. Therefore, pre 1.0 'y' is a\n> + close equivalent to a major release.\n> +\n> + 1.y.z : Stable API and ABI guarantees on the Major version number.\n> + Following semantic versioning as documented at https://semver.org/\n> +\n> +\n> The source code is available from the project's `git tree`_.\n> \n> .. code-block:: shell\n> @@ -47,9 +66,13 @@ The source code is available from the project's `git tree`_.\n> \n> .. _git tree: https://git.libcamera.org/libcamera/libcamera.git/\n> \n> -A mirror is also hosted on `LinuxTV`_.\n> +A development mirror is also hosted on `Freedesktop`_.\n> \n> -.. _LinuxTV: https://git.linuxtv.org/libcamera.git/\n> +.. _Freedesktop: https://gitlab.freedesktop.org/camera/libcamera\n> +\n> +Freedesktop also provides our CI and `testing pipeline`_.\n> +\n> +.. _testing pipeline: https://gitlab.freedesktop.org/camera/libcamera/-/pipelines\n> \n> Issue Tracker\n> -------------","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 987F9C3260\n\tfor ;\n\tTue, 25 Nov 2025 05:31:16 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 478A060A9D;\n\tTue, 25 Nov 2025 06:31:16 +0100 (CET)","from fanzine2.igalia.com (fanzine2.igalia.com [213.97.179.56])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 2D9BE608CF\n\tfor ;\n\tTue, 25 Nov 2025 06:31:14 +0100 (CET)","from maestria.local.igalia.com ([192.168.10.14]\n\thelo=mail.igalia.com) by fanzine2.igalia.com with esmtps \n\t(Cipher TLS1.3:ECDHE_SECP256R1__RSA_PSS_RSAE_SHA256__AES_256_GCM:256)\n\t(Exim) id 1vNldx-00527b-Jw; Tue, 25 Nov 2025 06:31:13 +0100","from webmail.service.igalia.com ([192.168.21.45])\n\tby mail.igalia.com with esmtp (Exim)\n\tid 1vNldv-00DAzu-3q; Tue, 25 Nov 2025 06:31:13 +0100","from localhost ([127.0.0.1] helo=webmail.igalia.com)\n\tby webmail with esmtp (Exim 4.96) (envelope-from )\n\tid 1vNldu-002Nu7-23; Tue, 25 Nov 2025 06:31:10 +0100"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=igalia.com header.i=@igalia.com\n\theader.b=\"dJeSnWSp\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=igalia.com;\n\ts=20170329;\n\th=Content-Transfer-Encoding:Content-Type:Message-ID:References:\n\tIn-Reply-To:Subject:Cc:To:From:Date:MIME-Version:Sender:Reply-To:Content-ID:\n\tContent-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc\n\t:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe:\n\tList-Post:List-Owner:List-Archive;\n\tbh=P8xnQZWwH8H/MB1bB5szN2qdnmAn/EX3+qBgohAvu78=;\n\tb=dJeSnWSpcDdM1j3+B8zvJnncRj\n\tEg4j8zGCB3tzs4Bmo+DqiMjpJSyedX0k2v1lN0SsruC56UTNJaw5YLrGZTz3Oj3O77DJCjk8Kr3Nb\n\tvcPThdO5V97Q1Ej9AZUseu0Q0ineZg0pQyWX70U8WtKqykbYv7N1jIi8w/5nq6tkwp4GyjOInHDEG\n\tWtKlL6f8ksH/I2gDlzKqZ2nLwJD33OIf0t8xaC8INtMh9mkpErVFcC7H4mlEkXI0bFSkiQuWf7gIX\n\t0XOAelFfM/4dQ+NFvl98nzXsi+kKHNcTYo7bxKMZqaUcPmdQO7j13vw2CoJ/uC6ZmZPyPz7rWBoTK\n\tC9wFdcfA==;","MIME-Version":"1.0","Date":"Tue, 25 Nov 2025 11:01:10 +0530","From":"Umang Jain ","To":"Kieran Bingham ","Cc":"libcamera devel ","Subject":"Re: [PATCH 3/3] Documentation: contributing: Update Source\n\treferences","In-Reply-To":"<20251124165631.3040364-4-kieran.bingham@ideasonboard.com>","References":"<20251124165631.3040364-1-kieran.bingham@ideasonboard.com>\n\t<20251124165631.3040364-4-kieran.bingham@ideasonboard.com>","Message-ID":"<912096ed11cf804ad27399ba57afc253@igalia.com>","X-Sender":"uajain@igalia.com","Content-Type":"text/plain; charset=US-ASCII","Content-Transfer-Encoding":"7bit","X-Spam-Report":"NO, Score=-2.2, Tests=ALL_TRUSTED=-3, AWL=-0.000, BAYES_50=0.8,\n\tURIBL_BLOCKED=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001","X-Spam-Score":"-21","X-Spam-Bar":"--","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}}]