From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 2FDFA42ECA; Thu, 20 Jul 2023 10:03:24 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 08B4340EE7; Thu, 20 Jul 2023 10:03:24 +0200 (CEST) Received: from NAM12-MW2-obe.outbound.protection.outlook.com (mail-mw2nam12on2061.outbound.protection.outlook.com [40.107.244.61]) by mails.dpdk.org (Postfix) with ESMTP id 5DE9A40DF5; Thu, 20 Jul 2023 10:03:22 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=n5stFKbJiKTxbR9UWwACcfVywbwy3RB0O9+51Mp/LZFS9B07BvnH0sLtoLTZK+cDtgTk6kZkhOvzc4Uf4r9glYa0M9l+BD06oFQOXBEMD19AnyR48DbMu08ePMLcd39YPSLGPGxgTqxFY2vwc9xMBeKHK7JTlQrIe8f8a6uabgnWW8h3MKXcegTjLvAp7UloYrm4mEsyk5oAs0b1Ts1b4+fXWnUPTzZVaT43sDiQEdYh9KgORqayAcqkfxZZsTWA7IZ+345be3nEyL5mY+GMj2z8xqZRDnpcpyNgJR0SFN4lkDqljSeEO5myAGS4VbVOiCG7apmHptXMzJJhvXJ5bA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=GCbU82fJeXVARUo2hM+0a4Qb5U60pvUKsJGeY+FZLsM=; b=R5/I6PFN8aRiwRo2gVht3ba9hmmZ8g/Psa0h3EMyiHtifHYzP7bY6Z9wiOhUUxBw6r7bI+/KMuwqfKcDTtAjw7IChI8hQe8/ME+bxu1jkeRdZBtIzoWW0ktD/8MI1OFEoeo/4Yw5guxIaC16Ks08q9NIlAI6TBNxXYYwq+suj4wPMwWusOEBgXobUCKySpoY65OSNfwq+Z+QTVjei9PAC8c15DtSfQhQlDVGN2sCJtVcSzVPg2fHhSATwXB2Bu+mguMM4PrQCIDLrZGDQqmaO+42GC8eQKlRusNTn4ksiyoWFTFNCXVuqd+8oLzhz8ZKbrCBd4fn/1CZZBC8eTqdZA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=amd.com; dmarc=pass action=none header.from=amd.com; dkim=pass header.d=amd.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=GCbU82fJeXVARUo2hM+0a4Qb5U60pvUKsJGeY+FZLsM=; b=2ewdOawWpFPPTOU0hwRUL+EQc8H3eHR5un4iJu0vOJG/LwgMAq+UgIfU0IxI6K3WfTPU8UycRD6TfFZK+nRQV9nVtmOsyqsVYpK3ixzR7GY3tlBsnY3pCt08H16Fmutoqa0kvuEYlc2W0sqad1KgbgzzG4L/RBDRc13tJRxxnv8= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=amd.com; Received: from CH2PR12MB4294.namprd12.prod.outlook.com (2603:10b6:610:a9::11) by DS7PR12MB6359.namprd12.prod.outlook.com (2603:10b6:8:94::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6588.31; Thu, 20 Jul 2023 08:03:20 +0000 Received: from CH2PR12MB4294.namprd12.prod.outlook.com ([fe80::15a9:4e83:4217:8b49]) by CH2PR12MB4294.namprd12.prod.outlook.com ([fe80::15a9:4e83:4217:8b49%7]) with mapi id 15.20.6588.031; Thu, 20 Jul 2023 08:03:20 +0000 Message-ID: <6db81d4a-4d5d-3d20-be73-01f7b56c0114@amd.com> Date: Thu, 20 Jul 2023 09:03:13 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.13.0 Subject: Re: [dpdk-dev] [PATCH v1] doc: process for new library approval in principle Content-Language: en-US To: jerinj@marvell.com, dev@dpdk.org Cc: thomas@monjalon.net, david.marchand@redhat.com, techboard@dpdk.org References: <20230213092616.3589932-1-jerinj@marvell.com> <20230518132139.1350234-1-jerinj@marvell.com> From: Ferruh Yigit In-Reply-To: <20230518132139.1350234-1-jerinj@marvell.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-ClientProxiedBy: PA7P264CA0239.FRAP264.PROD.OUTLOOK.COM (2603:10a6:102:372::12) To CH2PR12MB4294.namprd12.prod.outlook.com (2603:10b6:610:a9::11) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CH2PR12MB4294:EE_|DS7PR12MB6359:EE_ X-MS-Office365-Filtering-Correlation-Id: 05feca07-a92e-40f4-8204-08db88f7c814 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: kdzCG4c+SWZfNVgc7xGqaRMWEpsA/Gb4huOLl/e+Hj9ClRE8k85BtxRUNqcF3wqP4sX8xGC2dvbaNeBftnJnxlkAQlMB/chyjcZWeke+/C+Oc7PbshJ+IQ2/errT0qw3Ebx31b0+3uW7VhOKtdaEvbnfL5pAxGTx3b8oir8vww9LvL1ArqIFiHNgcJ+/+SukGIeGeaE34Eaqnoyp8w00J9Xw2Hrxn9kmbIC6FRHgxyoG8+DcR6kzaI4cqh1RBS36GllY3myxK4e1hRVwBEif7Cak2fqqnHMbQquAE+NE3LJ1DyOfhbr8CJJQcBMVbZJFuAV9lTutHjg/zpOmjQ4JgN2z8ULImW2ORadz0AUa6qGc0D1VL6NvIRX7rVY4GX6uGS1JzYEFvjf5EalVOwBCJF1QQOMQEamRI6k2QBstYqDDJeRs+q33ri9plrYHjggeRqF/sB6BgN3brOydAqscEiJeIuNuJMGx5KDpqOh6SBeTU12fbLDTmF9AQFA+r88BSuLjZxieXb0pXPSIgww4nX8FPSz02YZGMvvjGg5DFSNctbx4yg0AQsa1iiYNPd2Lz0gE+p5pgg52x7SA7EgSNevpRejhGIcZiGqtgbW0cqC79E//J8ZFNWDe0i4+GIFG9UgF2dos8iEEKsHcCYuHPw== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CH2PR12MB4294.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230028)(4636009)(376002)(136003)(396003)(39860400002)(346002)(366004)(451199021)(38100700002)(6486002)(6666004)(8936002)(8676002)(41300700001)(5660300002)(316002)(478600001)(4326008)(66476007)(66556008)(66946007)(6512007)(186003)(83380400001)(966005)(2616005)(53546011)(26005)(6506007)(31696002)(86362001)(44832011)(2906002)(36756003)(31686004)(43740500002)(45980500001); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?UFlxWTJrTUpvUTk5NXBkRUJ4M0taOWJDdTByZHBtbXg2Zm8zUHJVejNYdlRx?= =?utf-8?B?S2NpM3JRQkNHVEMyZWlUZUpLeE5xZWhTNXVlSThXY0FiYU9KS1ArUkdRc0NY?= =?utf-8?B?eXVQb1h3K09Ka3lhdVBTSVVEUlVZL2wzMVZidmJlSHNlN09rOWtqdzZ5R2tF?= =?utf-8?B?VWRQTVhhNVFOU2dQUGJvSVZ4YlZwRXZGYTlld1hZbXMyVTdvcjBPeDZDQVFa?= =?utf-8?B?SzJScXdEM2lvU3d3MTlWMEVvTU1tQUJHUDJMN1lEME9USmhRUnFScHFPT09a?= =?utf-8?B?ODF5WURuMnBPWFYrZ1AzWS9tclY0WEQzRE9tcWlmYmpCK2V6eElZV2cxTFVN?= =?utf-8?B?VlNxbXdBRmFsYnltYXprYkw2amt2YUZZMENvd1R5aSs4YUNWU2R6bktqYkc5?= =?utf-8?B?TFZlemNUamZPY3dIeXFGc1BvQjV0TnhOUm45QWRveVRoTjVKVTZhd2tBak05?= =?utf-8?B?MDQ2VitnQTBVdlk2aTJsWWtFU0J3aWV2U2dGdUFTUTVwdldjNzF5SXpkMkhu?= =?utf-8?B?eVVuWEhydXliYW5LUFkrd1NkMVc0VUUxVDY3RlIzY25pbzB3TUpWd3ZFQldr?= =?utf-8?B?ZWhPWithVWpYSG9aKzNDYnFCOVNvdC9FblJGWjdBa3dzK3F0VjVUZHY5SkxF?= =?utf-8?B?NENwNERPMHplelZrNDkva0V4TnBjZFprSmRJRWNHSnIwRFZtMkhDUmpkbkRZ?= =?utf-8?B?RXIxMXJWakdMZWNRdzlrSFJ5Skdxdm92OVI0bDFQVUM3RnRsbkM5Z3FialBy?= =?utf-8?B?WnBhSUhBWHVMV3J0QlV5R0NQVzJYNCt2Q1FXOTBOeVhhUk45WGEyZ1hldmhV?= =?utf-8?B?RW1TTlZNa3NsQVZrRVo3c1FObHV3eVBPVmRtWW1HNk9yb01rQkZPSXlZeCt5?= =?utf-8?B?bDErOXdOWU1WS0tRVHNUK21IUGUxdlhoQ2JxNjFMSklwZWZEK0dYaWZkS0ts?= =?utf-8?B?eHE2MWdQWDE5SGtzajZLQi9hZWluYk5lYnFXRTI5MXdFWGF2RFpNN21IQlhr?= =?utf-8?B?MnorRU1BTWZJTDFlQlIvSlY2R3hwS0lFU3pLQmdEVlpGKzVGbUhrZ2lTTURx?= =?utf-8?B?NWlEL1BhUGZBSk1QdTFxTDBFTE9aamNnWHVKMXRxTDZNMUlKR0o2NEhvUjY5?= =?utf-8?B?N082VkV5WVc1RVlVV3pIZGJYRHFES0YwcHFwT3l6a3A2MGRIWXVRaUg2ZTE1?= =?utf-8?B?Wk1xaXJQWFNMMldDdFdaYVpwbzNnSWdoQnJJQzk0VkNRU2owWEwwV2YrT05Y?= =?utf-8?B?N1lNWk9jazVVelNQYmJEejEwVHR1THdPcENmbWIySVB3elNScGRMYW5WOGg3?= =?utf-8?B?MUFjMytlN2JEcFpFN0Y5M2JMamlmRHY1T2Z0b3YyZnhWRkVaa1Q2RnI2bFZz?= =?utf-8?B?d1RIMmNpWjVCU1pHNG9qQ2ZKQWpGM0hkZ3IxVE0wQjVUZXpITEpVY082blVU?= =?utf-8?B?L0t3cDl5NklwcVo2WTM0bk1LOHhJMXdJNUNsWSswZExtRDRUaFd5NmcycTJ1?= =?utf-8?B?WnVmOEYyemNzSlZibHVvMnFXbk9yaE51MXRRQ1V3VWVKQ2NMVUV4TlFSV1Yy?= =?utf-8?B?UlZnNVpZZWx3SlFTSmoyK1d0VGpCeUtKR2hEc1JzMmhQdE5LTGdIOE1zYlFW?= =?utf-8?B?VWl2elR2UnR3WVIyQ05uU24vbEtvZm9UelB0L0hxR1NxTGRhMGdQSElBZ280?= =?utf-8?B?V2hBeWY5Q1luL1c2N0JHb3VmdWk5cHRsOUZTQW9oOTVnNFJ3U2FGVHQ0eGZL?= =?utf-8?B?YlBaRFcrOHVBdFJ3VDFxUEdMREVMQ1RRR21mejREUGI5WExUNmtBQ1VGQWZz?= =?utf-8?B?VlVUQmkxR1hVNkJpeTZqWUhod1JsdUJ5Zzh4NHJ0a0RmRUJDRWNVMHM3N3hr?= =?utf-8?B?dGtseVNPTmZNcUF3N1hkSFN4TW9Ud3ZHQlRJYVZxQVpSYVI3NEFUWmwzTWVW?= =?utf-8?B?RzF3SFViY25PZ1JrVnE0cmV0d1lLQ1k5b3hIWFkrc2thT016ajQvMDM2NXFX?= =?utf-8?B?UG9SYUFVc3Fxam8vT3hLSkRqLzh6eW1ncWhneTNOeWtxblpEVFMrblh6ejMw?= =?utf-8?B?c1Q0V1hwbTI5WHRhbkdsR2pNZ3h2a2tlY1M0QmgxQ1N1M0ZwU01ackl3ZFlN?= =?utf-8?Q?Yik5VK2tFMpvOGJjCABl0K4/G?= X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-Network-Message-Id: 05feca07-a92e-40f4-8204-08db88f7c814 X-MS-Exchange-CrossTenant-AuthSource: CH2PR12MB4294.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Jul 2023 08:03:19.9277 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: UGcRFrnKIvl24fbtl6LLpgRUUTC5g2CzZ9/4AdfjZxu2wVbQ4I/sYQKXKnja/I2N X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR12MB6359 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org On 5/18/2023 2:21 PM, jerinj@marvell.com wrote: > From: Jerin Jacob > > Based on techboard meeting[1] action item, defining the process for a > new library approval in principle. > > [1] > https://mails.dpdk.org/archives/dev/2023-January/260035.html > > Signed-off-by: Jerin Jacob > --- > RFC..v1: > - Fix the review comments by Konstantin, Keven, Thomas at > http://patches.dpdk.org/project/dpdk/patch/20230213092616.3589932-1-jerinj@marvell.com/ > > doc/guides/contributing/index.rst | 1 + > doc/guides/contributing/new_library.rst | 48 +++++++++++++++++++++++++ > 2 files changed, 49 insertions(+) > create mode 100644 doc/guides/contributing/new_library.rst > > diff --git a/doc/guides/contributing/index.rst b/doc/guides/contributing/index.rst > index 7a9e6b368e..ef627329f1 100644 > --- a/doc/guides/contributing/index.rst > +++ b/doc/guides/contributing/index.rst > @@ -18,3 +18,4 @@ Contributor's Guidelines > vulnerability > stable > cheatsheet > + new_library > diff --git a/doc/guides/contributing/new_library.rst b/doc/guides/contributing/new_library.rst > new file mode 100644 > index 0000000000..7dde8cbe64 > --- /dev/null > +++ b/doc/guides/contributing/new_library.rst > @@ -0,0 +1,48 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2023 Marvell. > + > +Process for new library approval in principle > +============================================= > + > +Rationale > +--------- > + > +Adding a new library to DPDK with proper RFC and then full patch-sets is significant work. > +In order to save effort, developers will get an early approval in principle, or early feedback in > +case the library is not suitable for various reasons. > + > +Process > +------- > + > +#. When a contributor would like to add a new library to DPDK code base, the contributor must send > + the following items to DPDK mailing list for technical board approval-in-principle. > + > + * Purpose of the library. > + * Scope of work: outline the various additional tasks planned for this library, such as > + developing new test applications, adding new drivers, and updating existing applications. > + * Expected usage models of the library. > + * Any licensing constraints. > + * Justification for adding to DPDK. > + * Any other implementations of the same functionality in other libraries/projects and how this > + version differs. > + * Public API specification header file as RFC. > + > + * Optional and good to have. > + * Technical board may additionally request this collateral if needed to get more clarity > + on scope and purpose. > + * Any new library dependencies to DPDK. > + > +#. Technical board to schedule discussion on this in upcoming technical board meeting along with > + author. Based on the technical board schedule and/or author availability, technical board may > + need a maximum of **five** technical board meeting slots. > + > +#. Based on mailing list and technical board meeting discussions, technical board to vote and share > + the decision in the mailing list. The decision outcome can be any of the following. > + > + * Approved in principal > + * Not approved > + * Further information needed > + > +#. Once technical board approves the library in principle, it is safe to start working on the > + implementation. However, the patches will need to meet the usual quality criteria in order to be > + effectively accepted. Looks reasonable to me, and it is good to start to document the process anyway, we can tweak it later if required, hence: Acked-by: Ferruh Yigit