From bb7572208c1c3d184d0a13b220e8029376808764 Mon Sep 17 00:00:00 2001 From: Sylvain LE GAL Date: Tue, 7 Nov 2023 11:30:06 +0100 Subject: [PATCH] =?UTF-8?q?[ADD]=20required=20knowledge=20Co-authored-by:?= =?UTF-8?q?=20Miquel=20Ra=C3=AFch=20=20Co-auth?= =?UTF-8?q?ored-by:=20Pedro=20M.=20Baeza=20?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docsource/020_required_knowledge.rst | 30 +++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/docsource/020_required_knowledge.rst b/docsource/020_required_knowledge.rst index 270b68734c3d..f93530d69307 100644 --- a/docsource/020_required_knowledge.rst +++ b/docsource/020_required_knowledge.rst @@ -1,4 +1,32 @@ Required Knowledge ================== -TODO : write here prerequisites. \ No newline at end of file +To Use Openupgrade +------------------ + +* you should be able to launch an instance of Odoo on your local PC, + or on your server, **for each version of your migration**. +* You should know how to get `openupgradelib`, obtained from the source repository, installed in your Python environment that is going to run the instance. +* You should know how to invoke the odoo executable, injecting arguments for loading server wide modules and migrations path. + For example, if you're migrating from version 12.0 to 16.0, + you should be able to launch Odoo versions 13.0, 14.0, 15.0 and 16.0. + +* If you're migrating to a recent version, + you'll certainly have to reference numerous open pull requests on OCA/OpenUpgrade, + for the modules installed on your instance. + In this case, using the `gitaggregate `_ + tool greatly facilitates the management of these numerous pull requests. + +To develop Openupgrade Scripts +------------------------------ + +- If you want to develop migration scripts for a given module, you need to have + complete functional (and technical) knowledge of this module. + For example, to develop migration scripts for `account` module from version 12.0 + to 13.0, you need to master how account is working in version 12.0 and how + account is working in version 13.0. + +- Knowledge of SQL is a must if you need to write fast queries on huge amounts of data. + +- you need to have a good understanding of the functions provided + by the `openupgradelib `_ library.