public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
* [PATCH] Update Who we are Wiki
@ 2020-09-30  9:40 gaoliming
  2020-10-01  8:58 ` Laszlo Ersek
  0 siblings, 1 reply; 2+ messages in thread
From: gaoliming @ 2020-09-30  9:40 UTC (permalink / raw)
  To: devel; +Cc: Laszlo Ersek, Leif Lindholm, Michael D Kinney, Guptha Soumya K

1. Highlight incompatible change
2. Define Release Maintainer Role

Signed-off-by: Liming Gao <gaoliming@byosoft.com.cn>
Cc: Laszlo Ersek <lersek@redhat.com>
Cc: Leif Lindholm <leif@nuviainc.com>
Cc: Michael D Kinney <michael.d.kinney@intel.com>
Cc: Guptha Soumya K <soumya.k.guptha@intel.com>
---
 Who-we-are.md | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/Who-we-are.md b/Who-we-are.md
index d9c7045..1972a4b 100644
--- a/Who-we-are.md
+++ b/Who-we-are.md
@@ -48,14 +48,18 @@ A Contributor is anyone with interest in contributing to Tianocore.org
     for code contributions to any of the EDK II Projects on
     Tianocore.org such as:
 
--   Post patches to edk2-devel
+-   Post patches to edk2-devel. 
+
+-   For the incompatible change, coordinate with the impacted platform maintainer and
+    make the agreement who will follow up to update the impacted platforms before
+    the patch set is merged. The impacted platforms include all ones in Edk2 and Edk2Platforms.
 
 -   Ask questions (edk2-discuss, edk2-rfc, edk2-devel)
 
 -   File bugs (TianoCore Bugzilla)
 
 -   Test and review patches for others as defined in the [process
-    rule](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Development-Process)s
+    rule](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Development-Process)
 
 -   Author or correct wiki articles
 
@@ -113,7 +117,8 @@ The role of a maintainer is to:
 
 1.  Process review requests in FIFO order.
 
-2.  Never let a pending request get older than a calendar week.
+2.  Never let a pending request get older than a calendar week. Initial
+    feedback can be provided first if the patch set is complex or big.
 
 3.  If you are out-of-office for an extended period of time, inform the
     Stewards and/or your co-maintainers about pending requests. Use
@@ -183,6 +188,23 @@ A Reviewer is anyone with interest in contributing to Tianocore.org
 
 -   Same rules apply from the Contributors.
 
+## Release Maintainer
+--------
+
+### Definition 
+
+Release Maintainer is responsible to create the quarterly stable tag.
+
+### Role
+
+-   Collect the feature planning for each stable tag.(https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Release-Planning)
+
+-   Schedule the release date (including soft feature freeze, hard feature freeze and release)
+
+-   Creat the stable tag with the release notes on tag page.(https://github.com/tianocore/edk2/tags)
+
+-   Send the announcement mail on soft feature freeze, hard feature freeze and the stable tag completement.
+
 ## Steward
 -------
 
-- 
2.27.0.windows.1



^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH] Update Who we are Wiki
  2020-09-30  9:40 [PATCH] Update Who we are Wiki gaoliming
@ 2020-10-01  8:58 ` Laszlo Ersek
  0 siblings, 0 replies; 2+ messages in thread
From: Laszlo Ersek @ 2020-10-01  8:58 UTC (permalink / raw)
  To: Liming Gao, devel; +Cc: Leif Lindholm, Michael D Kinney, Guptha Soumya K

The content looks great; some superficial comments:

On 09/30/20 11:40, Liming Gao wrote:
> 1. Highlight incompatible change
> 2. Define Release Maintainer Role

can we split this in two patches?

>
> Signed-off-by: Liming Gao <gaoliming@byosoft.com.cn>
> Cc: Laszlo Ersek <lersek@redhat.com>
> Cc: Leif Lindholm <leif@nuviainc.com>
> Cc: Michael D Kinney <michael.d.kinney@intel.com>
> Cc: Guptha Soumya K <soumya.k.guptha@intel.com>
> ---
>  Who-we-are.md | 28 +++++++++++++++++++++++++---
>  1 file changed, 25 insertions(+), 3 deletions(-)
>
> diff --git a/Who-we-are.md b/Who-we-are.md
> index d9c7045..1972a4b 100644
> --- a/Who-we-are.md
> +++ b/Who-we-are.md
> @@ -48,14 +48,18 @@ A Contributor is anyone with interest in contributing to Tianocore.org
>      for code contributions to any of the EDK II Projects on
>      Tianocore.org such as:
>
> --   Post patches to edk2-devel
> +-   Post patches to edk2-devel.
> +
> +-   For the incompatible change, coordinate with the impacted platform maintainer and

I suggest replacing

  the incompatible change

with

  changes incompatible with current platforms

> +    make the agreement who will follow up to update the impacted platforms before
> +    the patch set is merged. The impacted platforms include all ones in Edk2 and Edk2Platforms.
>
>  -   Ask questions (edk2-discuss, edk2-rfc, edk2-devel)
>
>  -   File bugs (TianoCore Bugzilla)
>
>  -   Test and review patches for others as defined in the [process
> -    rule](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Development-Process)s
> +    rule](https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Development-Process)
>
>  -   Author or correct wiki articles
>
> @@ -113,7 +117,8 @@ The role of a maintainer is to:
>
>  1.  Process review requests in FIFO order.
>
> -2.  Never let a pending request get older than a calendar week.
> +2.  Never let a pending request get older than a calendar week. Initial
> +    feedback can be provided first if the patch set is complex or big.
>
>  3.  If you are out-of-office for an extended period of time, inform the
>      Stewards and/or your co-maintainers about pending requests. Use

This could deserve its own patch -- my understanding is that this
clarification was really important to you, so it's not a small thing.

> @@ -183,6 +188,23 @@ A Reviewer is anyone with interest in contributing to Tianocore.org
>
>  -   Same rules apply from the Contributors.
>
> +## Release Maintainer
> +--------
> +
> +### Definition
> +
> +Release Maintainer is responsible to create the quarterly stable tag.
> +
> +### Role
> +
> +-   Collect the feature planning for each stable tag.(https://github.com/tianocore/tianocore.github.io/wiki/EDK-II-Release-Planning)

Do we need a space after the period?

> +
> +-   Schedule the release date (including soft feature freeze, hard feature freeze and release)
> +
> +-   Creat the stable tag with the release notes on tag page.(https://github.com/tianocore/edk2/tags)

Typo: should be "Create".

Also, space after period.

> +
> +-   Send the announcement mail on soft feature freeze, hard feature freeze and the stable tag completement.
> +
>  ## Steward
>  -------
>
>

Finally:

- please use the [wiki PATCH]  subject prefix, or similar (can be set
  with --subject-prefix)

- the subject lines should be a bit more meaningful, such as:

  [wiki PATCH 1/3] Who we are: highlight platform incompatibilities and coordination
  [wiki PATCH 2/3] Who we are: clarify patch review response time expected of Maintainers
  [wiki PATCH 3/3] Who we are: define Release Maintainer Role

Thanks!
Laszlo


^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2020-10-01  8:58 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-09-30  9:40 [PATCH] Update Who we are Wiki gaoliming
2020-10-01  8:58 ` Laszlo Ersek

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox