From patchwork Tue Apr 5 18:14:28 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 15621 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 1CEF6C0F1B for ; Tue, 5 Apr 2022 18:14:36 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 76EDF65642; Tue, 5 Apr 2022 20:14:35 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org; s=mail; t=1649182475; bh=Eye1SuNdh1a9U4bEV22sIPfvLC8JWKl8nriml1RHlLg=; h=To:Date:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=IfopUPS1Yip4YQq47TLKosaEW0yVFZacFavIBpQnOr3Nmzr5j8Nv0aNDtcTJEI+bS Bf0S6anKTbpoJQm69IHSxTItKyad2+lMZRuK9m3ixmYnpKxb8psi3XWdfZZPKIzssf 1lshEfL2GRBqQpizPRuGnyzoHTILl7E4B3TKdQN094iUyYC4IiBTdg3hjsOIDYyjc5 wIBdue1CPQJi5KMNlV2MZU2Uv3Jela+GtjeqEPunZVqInn8Dj9jGc0mPBPU05F5l4e PgemyTDjE/TX5JoAzTFhfav+xOUeUeAGeYbNTIFckKVgQmJJB2tEJHkBxrj/30sbPh f67jAcmaXNgxQ== Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id B2B08604BB for ; Tue, 5 Apr 2022 20:14:34 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="CShAXEqJ"; dkim-atps=neutral Received: from pendragon.home (117.145-247-81.adsl-dyn.isp.belgacom.be [81.247.145.117]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 4FB87499 for ; Tue, 5 Apr 2022 20:14:34 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1649182474; bh=Eye1SuNdh1a9U4bEV22sIPfvLC8JWKl8nriml1RHlLg=; h=From:To:Subject:Date:From; b=CShAXEqJE8RuxDterf7RafJzm92EBnQuTB+s3zEiUsbO2MZnTCFWQ0mZFiGlt5EDD 9itmb2izA4cu/qyNcwFxFshYFIystHFxiyLLQAqHqghttTDINx65LPfPqz5zEn4/LZ AUvvOqO3Amlfb68a8X1CWGwLSMiw7gzPFCbt2kag= To: libcamera-devel@lists.libcamera.org Date: Tue, 5 Apr 2022 21:14:28 +0300 Message-Id: <20220405181428.8485-1-laurent.pinchart@ideasonboard.com> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH] Documentation: Briefly document the mail-based contribution process 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: , X-Patchwork-Original-From: Laurent Pinchart via libcamera-devel From: Laurent Pinchart Reply-To: Laurent Pinchart Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" While familiarity with git is nowadays common, many developers are not familiar with mail-based patch submission. Add a paragraph to the contribution guide to mention that libcamera uses a mail-based process (which seems to have been taken for granted so much that we forgot to say it explicitly), and link to git-send-email.io to help newcomers setup git-send-email. Signed-off-by: Laurent Pinchart Reviewed-by: Umang Jain Reviewed-by: Jacopo Mondi --- Documentation/contributing.rst | 6 ++++++ 1 file changed, 6 insertions(+) base-commit: a2aa1b4c4e441b7b2fb40c976489b109c1de0bc4 diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst index b192c3b43153..8f06e3647e5d 100644 --- a/Documentation/contributing.rst +++ b/Documentation/contributing.rst @@ -68,6 +68,12 @@ code that is as easy to read, understand and maintain as possible. This is made possible by a set of :ref:`coding-style-guidelines` that all submissions are expected to follow. +The patch submission process for libcamera is similar to the Linux kernel, and +goes through the `libcamera-devel`_ mailing list. If you have no previous +experience with ``git-send-email``, or just trouble configuring it for your +e-mail provider, the sourcehut developers have put together a detailed guide +available at https://git-send-email.io/. + Patches submitted to the libcamera project must be certified as suitable for integration into an open source project. As such libcamera follows the same model as utilised by the Linux kernel, and requires the use of 'Signed-off-by:'