From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <dev-bounces@dpdk.org> Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id B48EFA0C41; Wed, 4 Aug 2021 12:40:05 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 67DC74014F; Wed, 4 Aug 2021 12:40:05 +0200 (CEST) Received: from wout3-smtp.messagingengine.com (wout3-smtp.messagingengine.com [64.147.123.19]) by mails.dpdk.org (Postfix) with ESMTP id 6301F4003E for <dev@dpdk.org>; Wed, 4 Aug 2021 12:40:04 +0200 (CEST) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.west.internal (Postfix) with ESMTP id 7FB3F320099D; Wed, 4 Aug 2021 06:40:02 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Wed, 04 Aug 2021 06:40:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s=fm1; bh= tK75XV0YXweOIEKulsBJ7jY4P2oCUj2n2lS5Ds04LMU=; b=bLX5gGgI6LndhN67 kEXNTd9/VT3wHDAWVX4k/j6puVNqApNxMCXojCdKBH+NtS3w/+u0KiVge7V6MiYs snmItknkOKSKtiz8YQzy4oTbFHRVq2IwmGr+y86xNP0LdYpMmTvAZK4FpO8td9Rr ZPsW3FC1vKPLb6JQd0oSbHg4fMQDcM9r6WeER8rTLUzDq1LF7Z9yHTc+lQVnqMBV fSHya5qoCvK0f4wzMxdc0zO8Swfjg/L8sNzCSaKsuLOrebZWdd7VE7VjCUtMgcvh hsT/KQ14X3WvOkZLVZfzugK+5m+5fhXtr1vVUK5jQ7P4oKSPaaJjAMcoep3tu0Dn 35fsUQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=tK75XV0YXweOIEKulsBJ7jY4P2oCUj2n2lS5Ds04L MU=; b=ht1jDjhL4Q9JAbH3iaR0eZgOZMuDEUaTRoclMSgDVfSJ5uK0f7r9d5qj2 aAmTrCcll2WhZSPOS87TxYEDee/AXhB6H5/18rsOhTicjoXVLvOwvrMB87UJK9+5 Sxv5IL8Q0cWUETBOgZt8baHkg/HTlxx7QwQMHn+7Eu7MEHB4rFYqyE7q8+Y+k9e1 12N8WPIRoUna2DtEbrqt2tIOZYpRWzut8Y1vt1hEXJsBR1+IdTktb/prlfPZePna GbIrh5HJ171OKqlN1dvU4+RaT7L1rqtdJ3A1SH7wikisIRoqsyb2hABLTYDAC/x/ EWSu38wf2J6izS10bqxkgxA0RR/7g== X-ME-Sender: <xms:gW4KYYaYs2-2C1heYBgq71W6vp4UBHWDvBC5qWbEa2jKMcl0wB_5HQ> <xme:gW4KYTZx_gH4BnhWN91ftHj1KYX1KLz6DpNxyDxmuNnsx2izWUZbqDr4xEgVPGFfm fcDNhmnUfbZd0cnMg> X-ME-Received: <xmr:gW4KYS8QNZx24ifZIQY3O-D5htCgcnuwUzVCgB8Ww9OpLaEeGCI0JGScrnNOuVEAnRhuqhdLLJygVplgBOm8dl3lVw> X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrieejgdduvdcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfgjfhgggfgtsehtufertd dttddvnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceothhhohhmrghssehm ohhnjhgrlhhonhdrnhgvtheqnecuggftrfgrthhtvghrnhepudeggfdvfeduffdtfeegle fghfeukefgfffhueejtdetuedtjeeuieeivdffgeehnecuvehluhhsthgvrhfuihiivgep tdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhhonhdrnh gvth X-ME-Proxy: <xmx:gW4KYSqKWSHYob9UIHrZkMcV5k1Y6i6O4RxjOqMbyXqxKUEysh6kww> <xmx:gW4KYTpUPawNhJDgm-RkhQ_LPy73MrppjyxfJoHS7o5QEsRqj9aWng> <xmx:gW4KYQSVJ-KpF24-h0EFfbK_fvL6F2SD-PYiG4s966fONQkTdm7QTQ> <xmx:gm4KYfK0Xv1fnOmJlPvX6MuxpxW4Z-ExyuDYAKSlNvRcrKEx8RA0UQ> Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 4 Aug 2021 06:40:00 -0400 (EDT) From: Thomas Monjalon <thomas@monjalon.net> To: Ray Kinsella <mdr@ashroe.eu> Cc: dev@dpdk.org, bruce.richardson@intel.com, john.mcnamara@intel.com, roretzla@linux.microsoft.com, ferruh.yigit@intel.com, david.marchand@redhat.com, stephen@networkplumber.org, jerinjacobk@gmail.com Date: Wed, 04 Aug 2021 12:39:58 +0200 Message-ID: <2298571.ajXUNpiJai@thomas> In-Reply-To: <20210804093431.677707-1-mdr@ashroe.eu> References: <20210629160031.74681-1-mdr@ashroe.eu> <20210804093431.677707-1-mdr@ashroe.eu> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Subject: Re: [dpdk-dev] [PATCH v5] doc: policy on the promotion of experimental APIs 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>, <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>, <mailto:dev-request@dpdk.org?subject=subscribe> Errors-To: dev-bounces@dpdk.org Sender: "dev" <dev-bounces@dpdk.org> 04/08/2021 11:34, Ray Kinsella: > Clarifying the ABI policy on the promotion of experimental APIS to stable. > We have a fair number of APIs that have been experimental for more than > 2 years. This policy amendment indicates that these APIs should be > promoted or removed, or should at least form a conservation between the s/conservation/conversation/ > maintainer and original contributor. > > Signed-off-by: Ray Kinsella <mdr@ashroe.eu> > Acked-by: Tyler Retzlaff <roretzla@linux.microsoft.com> > --- > +#. Libraries or APIs marked as :ref:`experimental <experimental_apis>` may be > + changed or removed without prior notice, as they are not considered part of > + an ABI version. The :ref:`experimental <experimental_apis>` status of an API > + is not an indefinite state. [...] > +Promotion to stable > +~~~~~~~~~~~~~~~~~~~ > + > +An API's ``experimental`` status should be reviewed annually, by both the > +maintainer and/or the original contributor. Ordinarily APIs marked as > +``experimental`` will be promoted to the stable ABI once a maintainer has become > +satisfied that the API is mature and is unlikely to change. > + > +In exceptional circumstances, should an API still be classified as > +``experimental`` after two years and is without any prospect of becoming part of > +the stable API. The API will then become a candidate for removal, to avoid the > +accumulation of abandoned symbols. > + > +Should an API's Binary Interface change, usually due to a direct change to the API's Binary Interface? I assume you mean ABI. > +API's signature, it is reasonable for the review and expiry clocks to reset. The > +promotion or removal of symbols will typically form part of a conversation > +between the maintainer and the original contributor. Acked-by: Thomas Monjalon <thomas@monjalon.net> Applied with above changes, thanks.