From 19f81f4615175d8ce05b0f0010ffde698f5244a4 Mon Sep 17 00:00:00 2001
From: Don Kendall <dkendall@ledoweb.com>
Date: Wed, 27 May 2026 16:14:36 -0400
Subject: [PATCH] [DOC] 090_contribute: document [MIG] prefix; clarify [OU-*]

The current guide shows ``[ADD] account`` in the example and lists
``[FIX]`` / ``[IMP]`` / ``[OU-*]`` in the Note. Recent branches use
``[MIG]`` as the dominant prefix for first-pass module migration
scripts (e.g. ``[MIG] account``, ``[MIG] hr_recruitment``); ``[ADD]``
is now used almost exclusively by the analysis bot. ``[OU-*]`` is
used for framework-level changes rather than only "V13 and before".

Update the example and the Note to match the prefix pattern observed
on the 19.0 branch (last 200 commits: 58 ``[MIG]``, 27 ``[IMP]``,
20 ``[FIX]``, 9 ``[OU-*]``, 1 ``[ADD]``).
---
 docsource/090_contribute.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/docsource/090_contribute.rst b/docsource/090_contribute.rst
index 926ffce1aba6..181257e55f31 100644
--- a/docsource/090_contribute.rst
+++ b/docsource/090_contribute.rst
@@ -77,19 +77,26 @@ Examples: all the noupdate=0 new and del ir* records, or the NEW and DEL lines f
   .. code-block:: shell
 
       git add .
-      git commit -am "[ADD] account"
+      git commit -am "[MIG] account"
       git push MY_REMOTE 16.0-mig-account
 
 
   **Note:**
 
-    * For a fix of an existing migration scripts, use ``[FIX]``
+    * For a first-pass migration script for a module version, use ``[MIG]``.
+      This is the dominant prefix on recent branches (e.g. ``[MIG] account``,
+      ``[MIG] hr_recruitment``).
 
-    * For an improvement of an existing migration scripts, use ``[IMP]``
+    * For a fix of an existing migration script, use ``[FIX]``.
 
-    * For old versions when OpenUpgrade was a fork (in V13 and before),
-      use "[OU-ADD]" / "[OU-FIX]" and "[OU-IMP]" to distinguish Odoo team commits
-      and Openupgraders commits.
+    * For an improvement of an existing migration script, use ``[IMP]``.
+
+    * For changes to the OpenUpgrade framework, infrastructure, or
+      cross-cutting helpers (rather than a per-module migration script),
+      use ``[OU-ADD]`` / ``[OU-FIX]`` / ``[OU-IMP]``. These prefixes
+      originated in the V13-and-earlier era when OpenUpgrade shipped
+      patched copies of Odoo source files, and they remain in use today
+      for framework-level changes.
 
   * Propose your changes to the community for review, opening a Pull Request on github.