| | 1 | |
| | 2 | = Procedures and policies for releases of QtWebKit = |
| | 3 | |
| | 4 | Releases of QtWebKit are cut from WebKit's trunk. Some time before the release a new branch is created and hosted in a Git repository. After the release it becomes a maintenance branch. |
| | 5 | |
| | 6 | == Release branch creation == |
| | 7 | |
| | 8 | * The release branch is hosted at http://gitorious.org/+qtwebkit-developers/webkit/qtwebkit |
| | 9 | * It is created off the {{{master}}} branch at http://gitorious.org/webkit |
| | 10 | * Extra patches can be included in this branch |
| | 11 | * Source packages are created from this branch. |
| | 12 | |
| | 13 | == Getting changes into the release branch == |
| | 14 | |
| | 15 | After the release branch has been created there are two ways to integrate changes: |
| | 16 | |
| | 17 | * The commit is landed in the trunk and then it is cherry-picked into the release branch. |
| | 18 | * Time constraints prevent us from landing the patch and we have to include a change before landing it (exceptional patch). |
| | 19 | |
| | 20 | Exceptional patches must satisfy the following criteria before they are included in the release: |
| | 21 | |
| | 22 | * An entry with the attached patch is filed in bugs.webkit.org (using http://webkit.org/new-qtwebkit-bug ). |
| | 23 | * The entry is made dependent on the current tracker bug for patches pending trunk inclusion: https://bugs.webkit.org/show_bug.cgi?id=32653 . |
| | 24 | * The patch has a ChangeLog entry. |
| | 25 | * Patches that affect the API need to have a unit test included. |
| | 26 | * Patches that affect WebCore should have a layout test included, although this is not mandatory. |
| | 27 | * At least one WebKit reviewer signs off on the patch and no other reviewer objects. |
| | 28 | * The bug is linked from it's corresponding JIRA item at http://bugreports.qt.nokia.com/browse/QTWEBKIT |
| | 29 | |
| | 30 | == Cherry-picking changes into the release branch == |
| | 31 | |
| | 32 | If you'd like to include a patch in the release branch, please consider only fixes that |
| | 33 | |
| | 34 | * fix data corruption |
| | 35 | * fix crashes |
| | 36 | * fixes a previously broken build |
| | 37 | * regression from the last minor release |
| | 38 | * documentation changes |
| | 39 | * crucial usability issue (after discussion the mailing list) |
| | 40 | |
| | 41 | The separate [wiki:"QtWebKitBackportingFixes" Backporting Fixes] page tracks the changes to include, both changes from the trunk as well as exceptional patches. |
