[ADD] Documentation for OpenUpgrade manager

docsource/100_maintain_repository.rst

@@ -0,0 +1,97 @@
+Maintain OpenUpgrade Repository
+===============================
+
+The following documentation is about OpenUpgrade Maintainers.
+
+Set up the branch for a new Odoo release
+----------------------------------------
+
+.. code-block:: shell
+
+    # Configuration
+    export PREV=16.0 OLD=17.0 NEW=18.0
+
+    git clone https://github.com/OCA/OpenUpgrade -b $OLD
+    cd OpenUpgrade
+
+    NODOTPREV=${PREV/\./}         # e.g. 16.0 -> 160
+    NODOTDOLD=${OLD/\./}          # e.g. 17.0 -> 170
+    NODOTNEW=${NEW/\./}           # e.g. 18.0 -> 180
+    ESCAPEDPREV=${PREV/\./\\\.}   # e.g. 16.0 -> 16\.0
+    ESCAPEDOLD=${OLD/\./\\\.}     # e.g. 17.0 -> 17\.0
+
+    # Create a new empty branch
+    git checkout --orphan $NEW
+    git rm -rf .
+    git commit --allow-empty --no-verify -m "[INIT] $NEW: Initialize branch"
+    git push origin $NEW
+
+    # Create a dedicated branch
+    git checkout -b $NEW-initialize
+
+    # Recover all the code from the old branch,
+    # - Remove coverage docsource file from old version
+    # - openupgrade_framework will be migrated in a future PR.
+    # - Remove scripts from old version
+    git format-patch --keep-subject --stdout $NEW..$OLD -- \
+        ':!docsource' \
+        ':!openupgrade_framework' \
+        ':!openupgrade_scripts/scripts' \
+        ':!openupgrade_scripts/apriori.py' \
+    | git am -3 --keep
+
+    # Replace No-Dot Syntax (140, 150, ...)
+    sed -i "s/$NODOTDOLD/$NODOTNEW/g" .github/workflows/*
+    sed -i "s/$NODOTPREV/$NODOTDOLD/g" .github/workflows/*
+
+    # Replace Doted Syntax (14.0, 15.0, ...)
+    sed -i "s/$ESCAPEDOLD/$NEW/g" \
+        .github/workflows/* \
+        .pylintrc* \
+        README.md \
+        openupgrade_scripts/readme/* \
+        openupgrade_scripts/__manifest__.py
+
+    sed -i "s/$ESCAPEDPREV/$OLD/g" \
+        .github/workflows/* \
+        openupgrade_scripts/readme/*
+
+    git commit -am "[INIT] $NEW: Replace version numbers." --no-verify
+
+    # Initialize apriori.py file
+    cat << EOF > ./openupgrade_scripts/apriori.py
+    """ Encode any known changes to the database here
+    to help the matching process
+    """
+
+    # Renamed modules is a mapping from old module name to new module name
+    renamed_modules = {
+        # odoo
+        # odoo/enterprise
+        # OCA/...
+    }
+
+    # Merged modules contain a mapping from old module names to other,
+    # preexisting module names
+    merged_modules = {
+        # odoo
+        # odoo/enterprise
+        # OCA/...
+    }
+
+    # only used here for upgrade_analysis
+    renamed_models = {
+        # odoo
+        # OCA/...
+    }
+
+    # only used here for upgrade_analysis
+    merged_models = {
+        # odoo
+        # OCA/...
+    }
+
+    EOF
+
+    git add ./openupgrade_scripts/apriori.py
+    git commit -am "[INIT] $NEW: Initialize apriori.py file." --no-verify

docsource/index.rst

@@ -23,6 +23,7 @@ Contents:
    070_migration_files.rst
    080_migration_script_development.rst
    090_contribute.rst
+   100_maintain_repository.rst
 
 You should find the latest version of this documentation here: `<https://oca.github.io/OpenUpgrade>`_