contribute: Document backport workflow for GStreamer developers

Fixes https://gitlab.freedesktop.org/gstreamer/gst-docs/issues/21
This commit is contained in:
Sebastian Dröge 2018-11-12 19:37:56 +02:00
parent 62f5d603b2
commit 6805ea81f3

View file

@ -327,3 +327,38 @@ issue or merge request.
If you do not get a response, this is usually not a sign of people *ignoring*
the issue, but usually just means that it's fallen through the cracks or
people have been busy with other things.
# Workflows for GStreamer developers
## Backporting to a stable branch
Before backporting any changes to a stable branch, they should first be
applied to the `master` branch, and should obviously not have caused any known
outstanding regressions. The only exception here are changes that do not apply
to the `master` branch anymore.
Existing merge request against the `master` branch, including merged ones,
that should be considered for backporting in the future should be labeled with
the `Needs backport` label unless there is any specific urgency to get it
backported. All merge requests with the (`Needs backport`)[needs-backport]
label will be regularly considered for backporting by GStreamer developers.
### Creating a merge request for backports
When creating a merge request for backporting changes, include one or more
changes in the merge request and ideally all from the (list)[needs-backport]
after reviewing them and potentially fixing them to work cleanly with the
stable branch.
If there are specific commits or areas of commits where further feedback is
needed, please create a task list in the description of the merge request and
@ the committer or whoever has knowledge about this commit.
Add another task to the task list in the merge request's description for the
module's maintainer(s) to confirm the merge and @ one or more maintainers.
Only once the CI succeeded for the merge request and all tasks are solved,
especially the confirmation from the maintainer(s), the merge request can be
merged.
[needs-backport]: https://gitlab.freedesktop.org/groups/gstreamer/-/merge_requests?state=merged&label_name[]=Needs%20backport