[edk2-wiki PATCH 0/2] document the Soft and Hard Feature Freezes

[edk2-wiki PATCH 0/2] document the Soft and Hard Feature Freezes

[Laszlo Ersek]

The recently added "EDK II Release Planning" wiki page refers to the
Soft and Hard Feature Freezes, but the definitions are missing. This
series provides them, and updates the planning page to link them.

The pages can be read "live" in my wiki clone, by starting from

  https://github.com/lersek/edk2/wiki/EDK-II-Release-Planning

and by following the links. (At commit 3a54508927ce, pointed-to by both
the "soft_hard_freeze" and "master" branches.)

Cc: Andrew Fish <afish@apple.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Michael D Kinney <michael.d.kinney@intel.com>

Thanks,
Laszlo

Laszlo Ersek (2):
  release planning: describe the hard and soft feature freezes
  release planning: link soft and hard feature freeze definitions

 EDK-II-Release-Planning.md | 12 +++---
 HardFeatureFreeze.md       |  6 +++
 SoftFeatureFreeze.md       | 42 ++++++++++++++++++++
 3 files changed, 54 insertions(+), 6 deletions(-)
 create mode 100644 HardFeatureFreeze.md
 create mode 100644 SoftFeatureFreeze.md

-- 
2.14.1.3.gb7cf6e02401b

[edk2-wiki PATCH 1/2] release planning: describe the hard and soft feature freezes

[Laszlo Ersek]

Adopt QEMU's definitions for the soft and hard feature freezes, and update
them for the edk2 process.

(In particular, while we don't forbid such pull requests that are
submitted to the mailing list, we usually apply patches from emails with
git-am, rather than merge remote branches.)

Cc: Andrew Fish <afish@apple.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
---
 HardFeatureFreeze.md |  6 +++
 SoftFeatureFreeze.md | 42 ++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/HardFeatureFreeze.md b/HardFeatureFreeze.md
new file mode 100644
index 000000000000..01288dd03f71
--- /dev/null
+++ b/HardFeatureFreeze.md
@@ -0,0 +1,6 @@
+After the hard feature freeze, the master branch in git is no longer open for
+general development. Only bug fixes will be accepted until the next [stable
+tag](EDK-II#stable-tags).
+
+(This definition is modeled after QEMU's [hard feature
+freeze](https://wiki.qemu.org/Planning/HardFeatureFreeze)).
diff --git a/SoftFeatureFreeze.md b/SoftFeatureFreeze.md
new file mode 100644
index 000000000000..9dc7d9c19369
--- /dev/null
+++ b/SoftFeatureFreeze.md
@@ -0,0 +1,42 @@
+# What is the soft feature freeze?
+
+The soft feature freeze is the beginning of the stabilization phase of edk2's
+development process. By the date of the soft feature freeze,  developers must
+have sent their patches to the mailing list **and** received positive
+maintainer reviews (`Reviewed-by` or `Acked-by` tags). This means that
+features, and in particular non-trivial ones, must have been accepted by
+maintainers before the soft freeze date.
+
+Between the soft feature freeze and the [hard feature
+freeze](HardFeatureFreeze), previously reviewed and unit-tested features may be
+applied (or merged) to the master branch, for integration testing. Feature
+addition or enablement patches posted **or** reviewed after the soft feature
+freeze will be delayed until after the upcoming [stable
+tag](EDK-II#stable-tags).
+
+# What should I do by the soft feature freeze?
+
+As a maintainer, for any feature that you're targeting to the next [stable
+tag](EDK-II#stable-tags), you should make sure that you've reviewed and
+accepted the patches related to the feature.
+
+As a developer, you probably should target a date that is at least 1-2 weeks
+earlier than the soft freeze date. This will give the maintainer enough time to
+review and test your patches. For major features you should probably
+communicate with the maintainer about their intentions. It also helps if you:
+
+- Enter a Bugzilla ticket for the [TianoCore Feature
+  Requests](https://bugzilla.tianocore.org/enter_bug.cgi?product=Tianocore%20Feature%20Requests)
+  product.
+
+- Optionally, write a Feature page in the [edk2 wiki](Home) describing the
+  feature and the motivation.
+
+- On the [release planning wiki page](EDK-II-Release-Planning), link to your
+  Bugzilla entry and/or the feature wiki page.
+
+- Do all this early enough that you can work with the maintainer to get the
+  review process underway.
+
+(This definition is modeled after QEMU's [soft feature
+freeze](https://wiki.qemu.org/Planning/SoftFeatureFreeze).)
-- 
2.14.1.3.gb7cf6e02401b

[edk2-wiki PATCH 2/2] release planning: link soft and hard feature freeze definitions

[Laszlo Ersek]

The "description" column refers to Soft Freeze and Hard Freeze, without
explaining them. Link the definitions added in the previous patch.

Cc: Andrew Fish <afish@apple.com>
Cc: Leif Lindholm <leif.lindholm@linaro.org>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
---
 EDK-II-Release-Planning.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/EDK-II-Release-Planning.md b/EDK-II-Release-Planning.md
index aee22d6bb548..744770521cca 100644
--- a/EDK-II-Release-Planning.md
+++ b/EDK-II-Release-Planning.md
@@ -2,12 +2,12 @@
 
 ## Proposed Schedule
 
-| Date       | Description              |
-| ---------- | ------------------------ |
-| 2018-08-15 | Beginning of development |
-| 2018-11-01 | Soft Freeze              |
-| 2018-11-08 | Hard Freeze              |
-| 2018-11-15 | Release                  |
+| Date       | Description                              |
+| ---------- | ---------------------------------------- |
+| 2018-08-15 | Beginning of development                 |
+| 2018-11-01 | [Soft Feature Freeze](SoftFeatureFreeze) |
+| 2018-11-08 | [Hard Feature Freeze](HardFeatureFreeze) |
+| 2018-11-15 | Release                                  |
 
 ## Proposed Features
 
-- 
2.14.1.3.gb7cf6e02401b

Re: [edk2-wiki PATCH 0/2] document the Soft and Hard Feature Freezes

[Kinney, Michael D]

Laszlo,

Thanks for adding these additional details.

Series Reviewed-by: Michael D Kinney <michael.d.kinney@intel.com>

Mike

> -----Original Message-----
> From: Laszlo Ersek [mailto:lersek@redhat.com]
> Sent: Thursday, August 16, 2018 7:52 AM
> To: edk2-devel-01 <edk2-devel@lists.01.org>
> Cc: Andrew Fish <afish@apple.com>; Leif Lindholm
> <leif.lindholm@linaro.org>; Kinney, Michael D
> <michael.d.kinney@intel.com>
> Subject: [edk2-wiki PATCH 0/2] document the Soft and
> Hard Feature Freezes
> 
> The recently added "EDK II Release Planning" wiki page
> refers to the
> Soft and Hard Feature Freezes, but the definitions are
> missing. This
> series provides them, and updates the planning page to
> link them.
> 
> The pages can be read "live" in my wiki clone, by
> starting from
> 
>   https://github.com/lersek/edk2/wiki/EDK-II-Release-
> Planning
> 
> and by following the links. (At commit 3a54508927ce,
> pointed-to by both
> the "soft_hard_freeze" and "master" branches.)
> 
> Cc: Andrew Fish <afish@apple.com>
> Cc: Leif Lindholm <leif.lindholm@linaro.org>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>
> 
> Thanks,
> Laszlo
> 
> Laszlo Ersek (2):
>   release planning: describe the hard and soft feature
> freezes
>   release planning: link soft and hard feature freeze
> definitions
> 
>  EDK-II-Release-Planning.md | 12 +++---
>  HardFeatureFreeze.md       |  6 +++
>  SoftFeatureFreeze.md       | 42 ++++++++++++++++++++
>  3 files changed, 54 insertions(+), 6 deletions(-)
>  create mode 100644 HardFeatureFreeze.md
>  create mode 100644 SoftFeatureFreeze.md
> 
> --
> 2.14.1.3.gb7cf6e02401b

Re: [edk2-wiki PATCH 0/2] document the Soft and Hard Feature Freezes

[Leif Lindholm]

On Thu, Aug 16, 2018 at 04:51:47PM +0200, Laszlo Ersek wrote:
> The recently added "EDK II Release Planning" wiki page refers to the
> Soft and Hard Feature Freezes, but the definitions are missing. This
> series provides them, and updates the planning page to link them.
> 
> The pages can be read "live" in my wiki clone, by starting from
> 
>   https://github.com/lersek/edk2/wiki/EDK-II-Release-Planning
> 
> and by following the links. (At commit 3a54508927ce, pointed-to by both
> the "soft_hard_freeze" and "master" branches.)
> 
> Cc: Andrew Fish <afish@apple.com>
> Cc: Leif Lindholm <leif.lindholm@linaro.org>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>

Looks good to me too.
For the series
Reviewed-by: Leif Lindholm <leif.lindholm@linaro.org>

> Thanks,
> Laszlo
> 
> Laszlo Ersek (2):
>   release planning: describe the hard and soft feature freezes
>   release planning: link soft and hard feature freeze definitions
> 
>  EDK-II-Release-Planning.md | 12 +++---
>  HardFeatureFreeze.md       |  6 +++
>  SoftFeatureFreeze.md       | 42 ++++++++++++++++++++
>  3 files changed, 54 insertions(+), 6 deletions(-)
>  create mode 100644 HardFeatureFreeze.md
>  create mode 100644 SoftFeatureFreeze.md
> 
> -- 
> 2.14.1.3.gb7cf6e02401b
> 

Re: [edk2-wiki PATCH 0/2] document the Soft and Hard Feature Freezes

[Laszlo Ersek]

On 08/16/18 16:51, Laszlo Ersek wrote:
> The recently added "EDK II Release Planning" wiki page refers to the
> Soft and Hard Feature Freezes, but the definitions are missing. This
> series provides them, and updates the planning page to link them.
> 
> The pages can be read "live" in my wiki clone, by starting from
> 
>   https://github.com/lersek/edk2/wiki/EDK-II-Release-Planning
> 
> and by following the links. (At commit 3a54508927ce, pointed-to by both
> the "soft_hard_freeze" and "master" branches.)
> 
> Cc: Andrew Fish <afish@apple.com>
> Cc: Leif Lindholm <leif.lindholm@linaro.org>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>
> 
> Thanks,
> Laszlo
> 
> Laszlo Ersek (2):
>   release planning: describe the hard and soft feature freezes
>   release planning: link soft and hard feature freeze definitions
> 
>  EDK-II-Release-Planning.md | 12 +++---
>  HardFeatureFreeze.md       |  6 +++
>  SoftFeatureFreeze.md       | 42 ++++++++++++++++++++
>  3 files changed, 54 insertions(+), 6 deletions(-)
>  create mode 100644 HardFeatureFreeze.md
>  create mode 100644 SoftFeatureFreeze.md
> 

Thank you Mike and Leif for the reviews; pushed as commit range
72401c4dfd53..fd72923586a5.

Thanks
Laszlo