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 9160643402; Wed, 29 Nov 2023 16:46:41 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 149A2409FA; Wed, 29 Nov 2023 16:46:41 +0100 (CET) Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.11]) by mails.dpdk.org (Postfix) with ESMTP id DCA39402CE for ; Wed, 29 Nov 2023 16:46:38 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1701272799; x=1732808799; h=date:from:to:cc:subject:message-id:references: in-reply-to:mime-version; bh=xosPBVPTVb6q2ogsYKaWYPkc/q8xuWiF1Z2TkEFifrA=; b=GoIFiQGP/ozZiYoF9hMU4wqUoIfRBDUJDOWNJoXPTaYR26pJIT7JCmuH ymrHIEWF2/2OqNukhOismC/569ZVUlAaLWIg99H2SZM4955o3VYQkAzgC nW5FjblzhI81MJVdq6NWfotoyKJzpme/RFeRRYvJe0DNskDusXn1cdxPC D+hU9Gs3/jJtxlnwSkRaLW3rrtRMxaqh7Tf6I3ESZKk/KcmCSStH4Eadc czkKy+i4P3l37kBH2xoiCJCyJ/71KlyedejJ2D3TdUD2yo0Xg/zg7g21/ LPy8t9GGvjB6uFwg0lANUAsxtGxas1IOjr7wIe7d0Xf0GrvbAfQefZtID Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10909"; a="54346" X-IronPort-AV: E=Sophos;i="6.04,235,1695711600"; d="scan'208";a="54346" Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmvoesa105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 29 Nov 2023 07:46:37 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10909"; a="892491247" X-IronPort-AV: E=Sophos;i="6.04,235,1695711600"; d="scan'208";a="892491247" Received: from orsmsx603.amr.corp.intel.com ([10.22.229.16]) by orsmga004.jf.intel.com with ESMTP/TLS/AES256-GCM-SHA384; 29 Nov 2023 07:46:36 -0800 Received: from orsmsx610.amr.corp.intel.com (10.22.229.23) by ORSMSX603.amr.corp.intel.com (10.22.229.16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.34; Wed, 29 Nov 2023 07:46:36 -0800 Received: from ORSEDG602.ED.cps.intel.com (10.7.248.7) by orsmsx610.amr.corp.intel.com (10.22.229.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.34 via Frontend Transport; Wed, 29 Nov 2023 07:46:36 -0800 Received: from NAM11-DM6-obe.outbound.protection.outlook.com (104.47.57.169) by edgegateway.intel.com (134.134.137.103) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.34; Wed, 29 Nov 2023 07:46:35 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jDGd3qIibCjuT+5xy27wwd2nxYD8a8UyfjhKTyDmzzz7TBox2BGMfR/6JgzeN/2UyWtc83lFjAF2v3bHsbD78IhD6rBb6rqtAimpZ/TFU0xlXUfcspGDhnWpGec8jZdGZuNDGZrnCT0NwYNklEb0p/lStQd/xw4MbPQbJ5xXRIS6Cap6mrkmWiIwWU3vQvGbqhg+PwhAEycPUMhDhOxwFr3JlEZBZxl/rGbn+OxVTO77XroXvZfKHc8EqrV0rj1iHWblg8bEze2XAZSd+b10GvwG6UVvKLhELMOtkQ6qW3q/v2GK49g4lpl4c9Qq5OvnGiQ+DtsCK7qm3lNu6oim+Q== 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=CWXSitFK2+C4VxAUFzJHqcNWweFylZpCyyQ1YPlhMfU=; b=X6jR7hb8ZFvG/CZbT27JYyhiIWPRVhT1daO3dAN6q5/Pf7QVy+thKOWCOyEuUk0sJawAyRoCw0JqbG1e5vQVtgo8NEkfD4OjJ5ipDW1DnUjWBEFLEW6hNqv8xOQrmUn3gcxi58n/aZRRf2ieslJou4/f3QcueHgvz0+Mf6iL+4CTCHkzfRYO6WsTtKDmUbszJ3KF/fkJ7ZKgduylYa3T6ChIOJFxIJ0tBnS/ghZ9MyQygXtQbkS3lXUDWrJNExMTBtNMzIhOIF/MLso8dQpvL2CyOV1aECUDUaeIqzdwAK9tVPIyQr3l1ygA56bkJiGax6URzsy94O3Emq8PcG8NJA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) by MN2PR11MB4742.namprd11.prod.outlook.com (2603:10b6:208:26b::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7046.22; Wed, 29 Nov 2023 15:46:33 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::4782:d54a:209d:cb49]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::4782:d54a:209d:cb49%7]) with mapi id 15.20.7046.023; Wed, 29 Nov 2023 15:46:33 +0000 Date: Wed, 29 Nov 2023 15:46:29 +0000 From: Bruce Richardson To: Stephen Hemminger CC: Subject: Re: [PATCH] doc: add sunset clause for experimental tag Message-ID: References: <20231129152742.7984-1-stephen@networkplumber.org> Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: <20231129152742.7984-1-stephen@networkplumber.org> X-ClientProxiedBy: DB9PR05CA0006.eurprd05.prod.outlook.com (2603:10a6:10:1da::11) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|MN2PR11MB4742:EE_ X-MS-Office365-Filtering-Correlation-Id: e8f7459e-55ab-4f9a-6f39-08dbf0f25ce3 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: TLmkmaotYfe7pHgE4+qs061Y/9ZjqA1prAhc/kfrhYCbUSYYDg91l1q6ZeB9jOWYRtIYDB2MfhP1X3NfD9i3mFfM3f7UGhE5Ck7sYVdK38lj14FTjufF53i9aPbRA/zmN2PeFaZHwhKRsEGFdVvSXWZt3/ar655nW3vmxi0Icl8qopF722XKOzWbKvDG6Cbl6GLzwkL1HS2n3X0TNcE0FWY59BSrf2yjkU+zB6N5Ev/tDt17PO4hh8oVxxVPQztn5n5FzcSLGVR+XVm6Gr2pNmhkRhzL4j99W2kv6e0OpLIDj0nHRq8/WG6tniM0mB9V0aboIJlAOxl2qdbacV8RwSSJAFvAffJY8a/TwAE2Cfrwfyau8/P4lO90CU/bS2dlvEm1VBAqnfSGWHnDQnVMzjmOivOE0eW7ZLmtkecrIBJfuOOCNxt6dDgNQ6mbRdIHIjcr7iCeok2hp+rTMtpqw8GnnMNRXxJrcSmiWPkgXJo90nx6wBrgQ7S/EbLrGDZz3tWdZDQ1H0XDBEZV2Khj/vPVnl2lfUSo5ZmLn29SB6RxVQ4boXWx7Ndhy0zycpVy X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DS0PR11MB7309.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(346002)(366004)(39860400002)(136003)(396003)(376002)(230922051799003)(186009)(1800799012)(64100799003)(451199024)(41300700001)(44832011)(86362001)(38100700002)(8676002)(6666004)(8936002)(5660300002)(4326008)(2906002)(26005)(6506007)(478600001)(316002)(66946007)(66556008)(66476007)(6486002)(6916009)(83380400001)(82960400001)(6512007); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?W7nKWEVpv+X5eoExyQvIib5C47x2f7Ur/TyNj2u8CPh19pYpkHpkgBsQD0Vv?= =?us-ascii?Q?UgCvLxzfVI3O+tMB5NP4/cuqco7NCdw6XjVafAueKKLsidJIgNWVf8iMTxnO?= =?us-ascii?Q?hsDw3y0TMAv+xyZQnAZWxEhYBqR9GUNRaZfu8ZJtGdFt/mZwFUA/Ll1+HiX5?= =?us-ascii?Q?9NCPLDal+XXHVeQVAwK23S+4oW6vaBMfLGhWb0XwYZt92hs0eYxiOBziZbni?= =?us-ascii?Q?rwllUekrg/v9ZPkQ97QzLEEremc8oG1BurmoYDE6Rdd13n2ALEAAf0OUaxl8?= =?us-ascii?Q?OqNcfkL9g9GVCL9yKAaIEPPUjsyx17VAybRTFEnfWJF1fN+/R2NThJQLSeJV?= =?us-ascii?Q?FbiKI/LRwgXySzG6ff4BAF7BM7u1eu8Tr2suABcz/6CNiZ/xr2A+rUyXrtEn?= =?us-ascii?Q?3SzcyJZYDCUrpO2yl3j9GU8P8fgg5IHMBUR4SNT/xD6qP+YHxSbGsy5/+cTn?= =?us-ascii?Q?qsMUz3toyFswmcCccX0po+0I/7WPem5zzXl7GtD6Yg76wFxOiOq7tPYvj/jE?= =?us-ascii?Q?fw9r5Z/T9+/ca0loKfsn7rINOfYaw0qawEEWNy+on1ypFATijBse5y1yRPKB?= =?us-ascii?Q?QJlGGKWyjCSsODx30w+xSwLRnusfb2H0S1xlaHgSXt5pIJ70CuEnNFehJyVV?= =?us-ascii?Q?h1HnTEZfC5TVuU8UKnHI+2EPhBOm5nEpuA1qzl7vMYqoxjGPcmZj3eXeDP0B?= =?us-ascii?Q?RFNVI7IY8hpLjlYmEyqIsLPsPHfbl1z8Sjk3IDuDMevd2nvce7626tJkPXZK?= =?us-ascii?Q?x1vW+AI3Pwwztit2Q0wejWrnsdyV4Yz47vqiMWCKdI3r78wAa9q2uHA3CiWV?= =?us-ascii?Q?o7prUawn8B1Yzm8eUZpjX0TEcFF/bct0evyaATqDTASoguDYQWwA1d5c8qXd?= =?us-ascii?Q?Hmkx8SoyVqM8IfV9zPG6SyVrEBo3Oo7w8zphIXD86X/++XqPKruGHNVLu+tR?= =?us-ascii?Q?w/scisMZms+WFdSYV7O7858S9Czuh500hxWfyMveoZcJN2MTTzbnvTwu1zSK?= =?us-ascii?Q?gwyD6qTR+9NfcRyc2s39nwp+qJL1kbbHxswd82j9viOg40pSRIIvtgvHKoIW?= =?us-ascii?Q?XHRCa47xCGq6wZLofWwJLgwx82GxxMdFIymcpbxm+Dz6GpaCsI4rGhGC2pji?= =?us-ascii?Q?xX5lf571D1bwcIEV8YXMEBn3OV5LAygye7s7gmg8JXa9ikBnP9eJUZFJDeml?= =?us-ascii?Q?TZ85tJhZ/JxxaHMEArs2rJWLvscwIffmhgB0LS/9oZYNd+Bjk3aj0+5RXu5u?= =?us-ascii?Q?AsZanmdBGnvfXBhSmYARr0ChEtm6JXBMHsQpSCHJT8TURKunZ2JaoxIJ+5XN?= =?us-ascii?Q?NFzg3YXdDQ/qZI1l7PVgK/Lx2c6rXrFJE8ffW2EJpnuvRVJWl7PXsfv4z18j?= =?us-ascii?Q?Spz5zYeqJfeN1hItCCSswSwJpocvzCsTmBf6VkXvcpc0mId5Aa3MPa6EOKNI?= =?us-ascii?Q?Ttdit+bOooTYSpKLCAPGBUVs432I2LZMeF35v0ybKhhLEi69KXtbp4taVhvq?= =?us-ascii?Q?ixC3G31+kTfwtlCu/ZxVh5aGhGamPwDqjwrIRsPDsiW9Brtm2wC0Wp+w9u46?= =?us-ascii?Q?OOJudtEUEC9dotrvipktKJVB3BkdZ5b5RjidhHYUMWl6E13QvNZivVKXDhxi?= =?us-ascii?Q?2A=3D=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: e8f7459e-55ab-4f9a-6f39-08dbf0f25ce3 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Nov 2023 15:46:33.6203 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: omFSWWOolBN0Z88TtIF08GCH26R3Y2qsWd8HoAbZjDT+jS6OweEDyRbECx9xKFUH95zeYgf9f7xp1bSt46jAEvVL8v0j1fSvXAaVtrR5/rU= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB4742 X-OriginatorOrg: intel.com 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 Wed, Nov 29, 2023 at 07:27:38AM -0800, Stephen Hemminger wrote: > The experimental tag is intended as temporary to avoid having > all of DPDK APIs as experimental and thereby rendering the > stable policy as worthless. > > Add some wording into the existing policy in doc. > > Signed-off-by: Stephen Hemminger > --- > doc/guides/contributing/abi_policy.rst | 10 ++++++++++ > 1 file changed, 10 insertions(+) > > diff --git a/doc/guides/contributing/abi_policy.rst b/doc/guides/contributing/abi_policy.rst > index 5fd405258592..fbf26ea24fd6 100644 > --- a/doc/guides/contributing/abi_policy.rst > +++ b/doc/guides/contributing/abi_policy.rst > @@ -328,6 +328,16 @@ new APIs and start finding issues with them, new DPDK APIs will be automatically > marked as ``experimental`` to allow for a period of stabilization before they > become part of a tracked ABI version. > > +The experimental tag has as limited lifetime (sunset provision). > +It is expected to be removed in a future release. > +The tag may be removed as soon as the second release with the new DPDK API. > +After one year, the API must be stable and tag removed unless an > +exception is approved by the technical board. > + We should also mention about the API being possibly removed or reworked. > +For example, the symbol ``rte_flow_dev_dump`` was introduced > +in 20.02 release as ``experimental``. The tag could have been removed > +in 20.05 release, and should have been removed in 21.03 release. > + > Note that marking an API as experimental is a multi step process. > To mark an API as experimental, the symbols which are desired to be exported > must be placed in an EXPERIMENTAL version block in the corresponding libraries' > -- > 2.42.0 >