Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/126993/?format=api
{ "id": 126993, "url": "https://patches.dpdk.org/api/patches/126993/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20230518132139.1350234-1-jerinj@marvell.com/", "project": { "id": 1, "url": "https://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20230518132139.1350234-1-jerinj@marvell.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20230518132139.1350234-1-jerinj@marvell.com", "date": "2023-05-18T13:21:39", "name": "[v1] doc: process for new library approval in principle", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "073861a66d19b9c5bc9052ccce9232f43e9f32b2", "submitter": { "id": 1188, "url": "https://patches.dpdk.org/api/people/1188/?format=api", "name": "Jerin Jacob Kollanukkaran", "email": "jerinj@marvell.com" }, "delegate": { "id": 1, "url": "https://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/20230518132139.1350234-1-jerinj@marvell.com/mbox/", "series": [ { "id": 28062, "url": "https://patches.dpdk.org/api/series/28062/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=28062", "date": "2023-05-18T13:21:39", "name": "[v1] doc: process for new library approval in principle", "version": 1, "mbox": "https://patches.dpdk.org/series/28062/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/126993/comments/", "check": "success", "checks": "https://patches.dpdk.org/api/patches/126993/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 0B2DB42B3A;\n\tThu, 18 May 2023 15:22:01 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id AA47A40E25;\n\tThu, 18 May 2023 15:22:00 +0200 (CEST)", "from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com\n [67.231.156.173])\n by mails.dpdk.org (Postfix) with ESMTP id 9540C4014F;\n Thu, 18 May 2023 15:21:59 +0200 (CEST)", "from pps.filterd (m0045851.ppops.net [127.0.0.1])\n by mx0b-0016f401.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id\n 34IDHo7w004789; Thu, 18 May 2023 06:21:57 -0700", "from dc5-exch01.marvell.com ([199.233.59.181])\n by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 3qmyexc5dm-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Thu, 18 May 2023 06:21:57 -0700", "from DC5-EXCH01.marvell.com (10.69.176.38) by DC5-EXCH01.marvell.com\n (10.69.176.38) with Microsoft SMTP Server (TLS) id 15.0.1497.48;\n Thu, 18 May 2023 06:21:55 -0700", "from maili.marvell.com (10.69.176.80) by DC5-EXCH01.marvell.com\n (10.69.176.38) with Microsoft SMTP Server id 15.0.1497.48 via Frontend\n Transport; Thu, 18 May 2023 06:21:54 -0700", "from jerin-lab.marvell.com (jerin-lab.marvell.com [10.28.34.14])\n by maili.marvell.com (Postfix) with ESMTP id 227875B693B;\n Thu, 18 May 2023 06:21:48 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com;\n h=from : to : cc :\n subject : date : message-id : in-reply-to : references : mime-version :\n content-transfer-encoding : content-type; s=pfpt0220;\n bh=oJ5753XInCunfV8RkWUe02AwlZd1ZIW44V+XkWUQigs=;\n b=lMHyHXfmiDl0gw0ah1/DWu1dYIFPu8vSXabI9Pc0mH7Pp/pYwxJZhDIiOCKV0JCutECh\n x1JzRfTYSBFupdgHBcUZOH8cQ43xHMIYg7piqMDR0LiRlJP9RB8OlgiQ6LzTYbwLsi7t\n DugRqXZvRf80ZDvMs32VQN7dlw6MNYX77cZVa/9fdK2+FkPczT4T0r+k727KdYzPrkzk\n +zNlZvKGJTzaB7a86AZ3tefssXobzaSkZDwn0YleLwt3chswu0/IsNn5MYc4Yr0yzz/f\n PMx42JFEoqSHJuc+X9dYM6cYy40xDSCkIE/vwhGScqps/qPHtBJRgUoxb5TyZ8Vv/XmJ Dw==", "From": "<jerinj@marvell.com>", "To": "<dev@dpdk.org>", "CC": "<thomas@monjalon.net>, <david.marchand@redhat.com>,\n <ferruh.yigit@amd.com>,\n <techboard@dpdk.org>, Jerin Jacob <jerinj@marvell.com>", "Subject": "[dpdk-dev] [PATCH v1] doc: process for new library approval in\n principle", "Date": "Thu, 18 May 2023 18:51:39 +0530", "Message-ID": "<20230518132139.1350234-1-jerinj@marvell.com>", "X-Mailer": "git-send-email 2.40.1", "In-Reply-To": "<20230213092616.3589932-1-jerinj@marvell.com>", "References": "<20230213092616.3589932-1-jerinj@marvell.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-Proofpoint-GUID": "dluQHK0F8pJmhXZbXJtNwwoE8b4TKGrG", "X-Proofpoint-ORIG-GUID": "dluQHK0F8pJmhXZbXJtNwwoE8b4TKGrG", "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.254,Aquarius:18.0.957,Hydra:6.0.573,FMLib:17.11.170.22\n definitions=2023-05-18_10,2023-05-17_02,2023-02-09_01", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "From: Jerin Jacob <jerinj@marvell.com>\n\nBased on techboard meeting[1] action item, defining the process for a\nnew library approval in principle.\n\n[1]\nhttps://mails.dpdk.org/archives/dev/2023-January/260035.html\n\nSigned-off-by: Jerin Jacob <jerinj@marvell.com>\n---\nRFC..v1:\n- Fix the review comments by Konstantin, Keven, Thomas at\nhttp://patches.dpdk.org/project/dpdk/patch/20230213092616.3589932-1-jerinj@marvell.com/\n\n doc/guides/contributing/index.rst | 1 +\n doc/guides/contributing/new_library.rst | 48 +++++++++++++++++++++++++\n 2 files changed, 49 insertions(+)\n create mode 100644 doc/guides/contributing/new_library.rst", "diff": "diff --git a/doc/guides/contributing/index.rst b/doc/guides/contributing/index.rst\nindex 7a9e6b368e..ef627329f1 100644\n--- a/doc/guides/contributing/index.rst\n+++ b/doc/guides/contributing/index.rst\n@@ -18,3 +18,4 @@ Contributor's Guidelines\n vulnerability\n stable\n cheatsheet\n+ new_library\ndiff --git a/doc/guides/contributing/new_library.rst b/doc/guides/contributing/new_library.rst\nnew file mode 100644\nindex 0000000000..7dde8cbe64\n--- /dev/null\n+++ b/doc/guides/contributing/new_library.rst\n@@ -0,0 +1,48 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2023 Marvell.\n+\n+Process for new library approval in principle\n+=============================================\n+\n+Rationale\n+---------\n+\n+Adding a new library to DPDK with proper RFC and then full patch-sets is significant work.\n+In order to save effort, developers will get an early approval in principle, or early feedback in\n+case the library is not suitable for various reasons.\n+\n+Process\n+-------\n+\n+#. When a contributor would like to add a new library to DPDK code base, the contributor must send\n+ the following items to DPDK mailing list for technical board approval-in-principle.\n+\n+ * Purpose of the library.\n+ * Scope of work: outline the various additional tasks planned for this library, such as\n+ developing new test applications, adding new drivers, and updating existing applications.\n+ * Expected usage models of the library.\n+ * Any licensing constraints.\n+ * Justification for adding to DPDK.\n+ * Any other implementations of the same functionality in other libraries/projects and how this\n+ version differs.\n+ * Public API specification header file as RFC.\n+\n+ * Optional and good to have.\n+ * Technical board may additionally request this collateral if needed to get more clarity\n+ on scope and purpose.\n+ * Any new library dependencies to DPDK.\n+\n+#. Technical board to schedule discussion on this in upcoming technical board meeting along with\n+ author. Based on the technical board schedule and/or author availability, technical board may\n+ need a maximum of **five** technical board meeting slots.\n+\n+#. Based on mailing list and technical board meeting discussions, technical board to vote and share\n+ the decision in the mailing list. The decision outcome can be any of the following.\n+\n+ * Approved in principal\n+ * Not approved\n+ * Further information needed\n+\n+#. Once technical board approves the library in principle, it is safe to start working on the\n+ implementation. However, the patches will need to meet the usual quality criteria in order to be\n+ effectively accepted.\n", "prefixes": [ "v1" ] }