[Mesa-dev] [PATCH 3/3] docs/releasing: Add note about using a staging branch

[Juan A. Suarez Romero]

For the first two patches in the series:

Reviewed-by: Juan A. Suarez <jasuarez at igalia.com>


For the 3rd patch, I'm fine with the proposal, but  I would like to know the
feedback from others. 

In my case, for instance, I'm already using a staging branch, but in a
completely different repository (on GitHub), as our CI integrates better here
than with the freedesktop repository, and I have more freedom to
add/remove/squash/reorder commits as I need in the branch.

But as I said, I'm fine with pushing those changes also to the staging branch in
the freedesktop repository (does it allow to force push?).


   	 J.A.

On Mon, 2018-05-21 at 10:34 -0700, Dylan Baker wrote:
> ---
>  docs/releasing.html | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)
> 
> diff --git a/docs/releasing.html b/docs/releasing.html
> index 07f100caae1..20fc4579a32 100644
> --- a/docs/releasing.html
> +++ b/docs/releasing.html
> @@ -249,6 +249,25 @@ Now go to
>  <a href="https://bugs.freedesktop.org/editversions.cgi?action=add&product=Mesa" target="_parent">Bugzilla</a> and add the new Mesa version X.Y.
>  </p>
>  
> +<p>
> +Use a stanging branch:
> +</p>
> +<pre>
> +    git checkout X.Y
> +    git checkout -b X.Y-proposed
> +</pre>
> +<p>
> +This branch should be reported to any teams using a CI to track upcoming stable
> +branches. This will allow that team to report an CI regressions to the release
> +manager, while leaving the X.Y branch in a continuously usable state. To
> +that end it is most useful if the release manager run the relavent scripts
> +(such as git-fixes-pick-list.sh) once per day, and update this branch. When it is
> +time to make a release, the X.Y branch should be rebased to the X.Y-proposed branch.
> +
> +The staging branch can be force pushed (for example, to remove a patch that
> +causes regressions), while the X.Y should not be force pushed.
> +</p>
> +
>  <p>
>  Check that there are no distribution breaking changes and revert them if needed.
>  For example: files being overwritten on install, etc. Happens extremely rarely -