From patchwork Tue Nov 14 10:40:09 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Nicolas Morey-Chaisemartin X-Patchwork-Id: 10057311 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 068D060231 for ; Tue, 14 Nov 2017 10:40:14 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E0DF528F20 for ; Tue, 14 Nov 2017 10:40:13 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id D43DD28F29; Tue, 14 Nov 2017 10:40:13 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 422E528F20 for ; Tue, 14 Nov 2017 10:40:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754866AbdKNKkL (ORCPT ); Tue, 14 Nov 2017 05:40:11 -0500 Received: from mx2.suse.de ([195.135.220.15]:51692 "EHLO mx2.suse.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752086AbdKNKkL (ORCPT ); Tue, 14 Nov 2017 05:40:11 -0500 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay2.suse.de (charybdis-ext.suse.de [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id E68E2ABFA for ; Tue, 14 Nov 2017 10:40:09 +0000 (UTC) From: Nicolas Morey-Chaisemartin Subject: [PATCHv2 rdma-core] Documentation: add documentation about stable branches To: linux-rdma@vger.kernel.org Openpgp: preference=signencrypt Message-ID: Date: Tue, 14 Nov 2017 11:40:09 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:56.0) Gecko/20100101 Thunderbird/56.0 MIME-Version: 1.0 Content-Language: fr-xx-classique+reforme1990 Sender: linux-rdma-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-rdma@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add doc file to detail the stable- process: release, submission. Signed-off-by: Nicolas Morey-Chaisemartin Cc: stable@linux-rdma.org # v15 --- Changes in v2: * Add missing new line at EOF * Remove UTF8 quotes * Add a line on ABI (will be extented once automated ABI checks are submitted) * Add Cc for stable-v15 to set a good example Documentation/stable.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 Documentation/stable.md diff --git a/Documentation/stable.md b/Documentation/stable.md new file mode 100644 index 00000000..39330038 --- /dev/null +++ b/Documentation/stable.md @@ -0,0 +1,65 @@ +# Stable Branch Release + + +## General + +Current Maintainer: Nicolas Morey-Chaisemartin + +Upstream rdma-core is considered stable after each mainline release. +Branched stable releases, off a mainline release, are on as-needed basis and limited to bug fixes only. + +All bug fixes are to be backported from mainline and applied by stable branch maintainer. + +Branched stable releases will append an additional release number (e.g. 15.1) and will ensure that Travis CI reports a successful build. + +Regular stable releases will be generated at the same time as mainline releases. +Additional stable releases can be generated if the need arise (Needed by distributions or OFED). + +## Patch Rules + + * It must be obviously correct and tested. + * It cannot be bigger than 100 lines, with context. + * It must fix only one thing. + * It must fix a real bug that bothers people (not a, "This could be a problem..." type thing). + * ABI must NOT be changed by the fix. + +## Submitting to the stable branch + +Submissions to the stable branch follow the same process as [kernel-stable](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/process/stable-kernel-rules.rst). + +### Option 1 + +Patches sent to master should add the tag: + + `Cc: stable@linux-rdma.org` + +in the sign-off area. Once the patch is merged, it will be applied to the stable tree +without anything else needing to be done by the author or subsystem maintainer. + +If the patch should be applied to more than one release, add the info version as such: + + `Cc: stable@linux-rdma.org # v15.1 v14` + + +### Option 2 + +After the patch has been merged to master, send an email to +stable@linux-rdma.org containing the subject of the patch, the commit ID, +why you think it should be applied, and what rdma-core version you wish it to +be applied to. + +### Option 3 + +Send the patch, after verifying that it follows the above rules, to stable@linux-rdma.org. +You must note the upstream commit ID in the changelog of your submission, + as well as the rdma-core version you wish it to be applied to. + +Option 1 is strongly preferred, is the easiest and most common. +Option 2 and Option 3 are more useful if the patch isn’t deemed worthy at the time it is applied to a public git tree (for instance, because it deserves more regression testing first). +Option 3 is especially useful if the patch needs some special handling to apply to an older version. + +Note that for Option 3, if the patch deviates from the original upstream patch (for example because it had to be backported) this must be very clearly documented and justified in the patch description. + +## Versioning + +See versioning.md for setting package version on a stable branch.