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 76985A0A0E; Wed, 3 Feb 2021 11:15:01 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id EEF802404C5; Wed, 3 Feb 2021 11:15:00 +0100 (CET) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [63.128.21.124]) by mails.dpdk.org (Postfix) with ESMTP id B7F232404C1 for ; Wed, 3 Feb 2021 11:14:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1612347298; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=wbtwIdc+Kx7ypNncb2Jn9NwvBsN6qdE3Fo8efFNs7f4=; b=DPWaCLHO5of29OVbJ5/7NrSsNDM/DWP+p7DUx+JcQDmAXViEANNIh2FwITg4LgA19I4mK5 yUg7oyOkMcEyMmpdiHxpnBfqavTPVwgSRlpaSS7LI9KZtoxQKO9omaD0VxlUy6GpmZpglx 7pp2RBHYBkipaYBcJ9lC1l6i7keHkhI= Received: from mail-vk1-f198.google.com (mail-vk1-f198.google.com [209.85.221.198]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-524-nKuMjid5PwuoRl5mkaOcOA-1; Wed, 03 Feb 2021 05:14:56 -0500 X-MC-Unique: nKuMjid5PwuoRl5mkaOcOA-1 Received: by mail-vk1-f198.google.com with SMTP id 138so5443404vky.13 for ; Wed, 03 Feb 2021 02:14:56 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=wbtwIdc+Kx7ypNncb2Jn9NwvBsN6qdE3Fo8efFNs7f4=; b=lf9mASk9Zs1Ik0QgT9SVecdL5fKrf5fD0n+8bVH23217mhbuAkjEKA+kptKePqflri ErETXVhB+xlLx8WLfNX/NsIusOeOyTRrE0nRRc+zETySUE06hT6Ed/7NOBhGAzjKjEpu pPcFizBfxBLluIitxUIqRO4YWzUfS6N2HJQ4gGZIKCaQqtKEbIa8DkK8qpC02a6++zNq U9ueHd0bxO0If4F/k7OIcWp0RbZduoWG5d9wrWKuZehSd5dhdVi/CK3pAWWBrumh2YSI qKVEWmFw9O1lNqOb9Sfvka0l7yOWCDU+du1fVfEAFUWJPDQyxygrpOEz/WifQ6kJGnPf UJWg== X-Gm-Message-State: AOAM532ZKRYdNEByp5Q4XVTESmc5O5VaRk37buuVJ3nJTJVxlv+ptbgU xmUrBU3MqooNqf2eFtsuBHLg4lSkmsQz2xKsIwl4fMmzIOABY1ViNh5tQaNg+eYUF82wytheiWY qGiQ3othaQiVDfaT8Xic= X-Received: by 2002:a67:2d0e:: with SMTP id t14mr1000000vst.27.1612347296113; Wed, 03 Feb 2021 02:14:56 -0800 (PST) X-Google-Smtp-Source: ABdhPJwnGAILw/O0lkeL+4S2Z0uPs10TjwtwG3RpLf2+Fuf+f1j4YPhfzMYjAW07vfg8O5qGf8bQY0z/mt4xTsozkCY= X-Received: by 2002:a67:2d0e:: with SMTP id t14mr999990vst.27.1612347295859; Wed, 03 Feb 2021 02:14:55 -0800 (PST) MIME-Version: 1.0 References: <1610304247-11455-1-git-send-email-asafp@nvidia.com> <20210203075827.2782653-1-thomas@monjalon.net> In-Reply-To: <20210203075827.2782653-1-thomas@monjalon.net> From: David Marchand Date: Wed, 3 Feb 2021 11:14:44 +0100 Message-ID: To: Thomas Monjalon Cc: dev , Asaf Penso , John McNamara Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=dmarchan@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="UTF-8" Subject: Re: [dpdk-dev] [PATCH v5 1/1] doc: add release milestones definition 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 Sender: "dev" On Wed, Feb 3, 2021 at 8:58 AM Thomas Monjalon wrote: > > From: Asaf Penso > > Adding more information about the release milestones. > This includes the scope of change, expectations, etc. > > Signed-off-by: Asaf Penso > Signed-off-by: Thomas Monjalon > Acked-by: John McNamara > --- > v2: fix styling format and add content in the commit message > v3: change punctuation and avoid plural form when unneeded > v4: avoid abbreviations, "Priority" in -rc, and reword as John suggests > v5: note that release candidates may vary > --- > doc/guides/contributing/patches.rst | 74 +++++++++++++++++++++++++++++ > 1 file changed, 74 insertions(+) > > diff --git a/doc/guides/contributing/patches.rst b/doc/guides/contributing/patches.rst > index 6dbbd5f8d1..650ae7ef9b 100644 > --- a/doc/guides/contributing/patches.rst > +++ b/doc/guides/contributing/patches.rst > @@ -660,3 +660,77 @@ patch accepted. The general cycle for patch review and acceptance is: > than rework of the original. > * Trivial patches may be merged sooner than described above at the tree committer's > discretion. > + > + > +Milestones definition > +--------------------- > + > +Each DPDK release has milestones that help everyone to converge to the release date. > +The following is a list of these milestones > +together with concrete definitions and expectations, > +for a typical release cycle. > +The number and expectations of release candidates might vary slightly. You can still mention that a typical release has 4 rc, since they are described below. Maybe add a link to https://core.dpdk.org/roadmap/#dates. > + > +Roadmap > +~~~~~~~ > + > +* Content: new features in libraries, drivers, applications, and examples. > +* Timeframe: to be published before the first day of the release cycle. On the form, roadmap announcements can be either a simple mail or a patch against dpdk-web. > + > +RFC > +~~~ > + > +* Content: public design review for the feature, explaining the need and the design. > +* Should include the API changes, in libraries and applications. > +* RFC is not mandatory but strongly advised to start early discussion. > +* Nice to have: driver implementation (full or draft), example code, and documentation. RFC mails/patches can be sent at any time. I would not list this as a release milestone. This part details what should be in a RFC patch for a feature to be considered for the Proposal deadline. How about merging this with the milestone below? On the other hand, those details apply to any RFC, so another option is to put those details earlier in the doc where RFC patches are described. > + > +Proposal Deadline > +~~~~~~~~~~~~~~~~~ > + > +* Content: either an RFC as stated above or a v1 patch. > +* Nice to have: code complete for libraries. > + > +rc1 > +~~~ > + > +* Priority: new or updated API. > +* New API should be defined and implemented in libraries. > +* The API should include Doxygen documentation > + and be part of the relevant .rst files (library, release notes). > +* Code and related documentation must be updated atomically in the same patch. > +* API should be used in a test application (``/app``). > +* At least one PMD should implement the API. > + It can be a draft but must be sent as a separate series. > +* The above should be sent to the mailing list at least 2 weeks before -rc1. > +* Nice to have: example code (``/examples``) This list has items not really specific to rc1, like documentation is mandatory, doc and code updates must be atomic... Can this be moved in a common section? > + > +rc2 > +~~~ > + > +* Priority: drivers. > +* New features should be implemented in drivers. > +* A driver change should include documentation > + in the relevant .rst files (driver, release notes). > +* Code and related documentation must be updated atomically in the same patch. > +* The above should be sent to the mailing list at least 2 weeks before -rc2. > + > +rc3 > +~~~ > + > +* Priority: applications. > +* New functionality that does not depend on libs update > + can be integrated as part of -rc3. > +* The app should include documentation in the relevant .rst files > + (app, release notes if significant). > +* Code and related documentation must be updated atomically in the same patch. > +* Last opportunity for miscellaneous changes. > +* Libs and drivers cleanup. > +* Small driver reworks. > +* Critical and minor bug fixes. > + > +rc4 > +~~~ > + > +* Documentation updates. > +* Critical bug fixes. > -- > 2.30.0 > -- David Marchand