From b439b999316f62b2ae9d1ae0a296425a7ed70460 Mon Sep 17 00:00:00 2001 From: Tom Rini Date: Fri, 17 May 2024 11:49:29 -0600 Subject: doc: process.rst: Use subsubheading for "Phases of the Development Process" These sections which talk about the different phases of the development process should be using the subsubheading identifier. Signed-off-by: Tom Rini Reviewed-by: Quentin Schulz --- doc/develop/process.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'doc/develop/process.rst') diff --git a/doc/develop/process.rst b/doc/develop/process.rst index 92477d05dd8..a66540a698c 100644 --- a/doc/develop/process.rst +++ b/doc/develop/process.rst @@ -34,7 +34,7 @@ It is followed by a *Stabilization Period*. The end of a Release Cycle is marked by the release of a new U-Boot version. Merge Window ------------- +^^^^^^^^^^^^ The Merge Window is the period when new patches get submitted (and hopefully accepted) for inclusion into U-Boot mainline. This period lasts for 21 days (3 @@ -44,7 +44,7 @@ This is the only time when new code (like support for new processors or new boards, or other new features or reorganization of code) is accepted. Twilight Time -------------- +^^^^^^^^^^^^^ Usually patches do not get accepted as they are - the peer review that takes place will usually require changes and resubmissions of the patches before they @@ -65,13 +65,13 @@ the Merge Window does not preclude patches that were already posted from being merged for the upcoming release. Stabilization Period --------------------- +^^^^^^^^^^^^^^^^^^^^ During the Stabilization Period only patches containing bug fixes get applied. Corner Cases ------------- +^^^^^^^^^^^^ Sometimes it is not clear if a patch contains a bug fix or not. For example, changes that remove dead code, unused macros etc. or -- cgit v1.2.3 From 0efc5a9f670144cad7f287711f25c69cba0fde39 Mon Sep 17 00:00:00 2001 From: Tom Rini Date: Fri, 17 May 2024 11:49:30 -0600 Subject: doc: process.rst: Document device tree resync rules Document the logic of when we do a full resync of the device trees used by OF_UPSTREAM as well as that cherry-picking is allowed as needed. Signed-off-by: Tom Rini Reviewed-by: Quentin Schulz --- doc/develop/process.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'doc/develop/process.rst') diff --git a/doc/develop/process.rst b/doc/develop/process.rst index a66540a698c..0542b3fc124 100644 --- a/doc/develop/process.rst +++ b/doc/develop/process.rst @@ -108,6 +108,19 @@ Differences to the Linux Development Process In U-Boot, ``"-rc1"`` will only be released after all (or at least most of the) patches that were submitted during the merge window have been applied. +Resyncing of the device tree subtree +------------------------------------ + +As explained in :doc:`devicetree/control` some platforms make use of device tree +files which come from a git subtree that mirrors the Linux Kernel sources +itself. For our purposes, we only track releases and not release candidates for +merging in our tree. These merges follow the normal merge window rules. + +In the case of specific changes, such as bug fixes or new platform support, +these can be "cherry-picked" and are subject to the normal merge rules. For +example, a bug fix can come in later in the window but a full re-sync only +happens within the merge window itself. + .. _custodians: Custodians -- cgit v1.2.3