[REF][MOV] documentation apocalypse

Prior to this commit, the Odoo documentation was mainly split between
two repositories: odoo/odoo/doc and odoo/documentation-user. Some bits
of documentation were also hosted elsewhere (e.g., wiki, upgrade, ...).
This was causing several problems among which:
  - The theme, config, Makefile, and similar technical resources had to
    be duplicated. This resulted in inconsistent layout, features, and
    build environments from one documentation to another.
  - Some pages did not fit either documentation as they were relevant
    for both users and developers. Some were relevant to neither of the
    two (e.g., DB management).
  - Cross-doc references had to be absolute links and they broke often.
  - Merging large image files in the developer documentation would bloat
    the odoo/odoo repository. Some contributions had to be lightened to
    avoid merging too many images (e.g., Odoo development tutorials).
  - Long-time contributors to the user documentation were chilly about
    going through the merging process of the developer documentation
    because of the runbot, mergebot, `odoo-dev` repository, etc.
  - Some contributors would look for the developer documentation in the
    `odoo/documentation-user` repository.
  - Community issues about the user documentation were submitted on the
    `odoo/odoo` repository and vice-versa.

Merging all documentations in one repository will allow us to have one
place, one theme, one work process, and one set of tools (build
environment, ...) for all of the Odoo docs.

As this is a good opportunity to revamp the layout of the documentation,
a brand new theme replaces the old one. It features a new way to
navigate the documentation, centered on the idea of always letting the
reader know what is the context (enclosing section, child pages, page
structure ...) of the page they are reading. The previous theme would
quickly confuse readers as they navigated the documentation and followed
cross-application links.

The chance is also taken to get rid of all the technical dangling parts,
performance issues, and left-overs. Except for some page-specific JS
scripts, the Odoo theme Sphinx extension is re-written from scratch
based on the latest Sphinx release to benefit from the improvements and
ease future contributions.

task-2351938
task-2352371
task-2205684
task-2352544

Closes #945

content/applications/finance/accounting/others/multicurrencies/exchange.rst

@@ -0,0 +1,112 @@
+=================================
+Record exchange rates at payments
+=================================
+
+Overview
+========
+
+Any company doing international trade faces the case where the payments
+are in a different currency.
+
+After receiving their payments, you have the option to convert the
+amount into your company currency. Multi currency payment implies rates
+fluctuations. The rate differences are automatically recorded by Odoo.
+
+Configuration
+=============
+
+Enable multi-currencies
+-----------------------
+
+In the accounting module, Go to :menuselection:`Configuration --> Settings` 
+and flag **Allow multi currencies**, then click on **apply**.
+
+.. image:: media/exchange_rate03.png
+   :align: center
+
+Configure the currency rates in :menuselection:`Configuration --> Currencies`.
+Write down the rate and make sure the currency is active.
+
+.. image:: media/exchange_rate02.png
+   :align: center
+
+In this document, the base currency is **Euro** and we will record payments
+in **Dollars**.
+
+.. image:: media/exchange_rate08.png
+   :align: center
+
+.. tip:: 
+    You can automatically fetch the currency rates from the **European
+    Central Bank** or from **Yahoo**. Please read the document : 
+    :doc:`how_it_works`.
+
+Configure your journal
+----------------------
+
+In order to register payments in other currencies, you have to **remove
+the currency constraint** on the journal. Go to the accounting
+application, Click on **More** on the journal and **Settings**.
+
+.. image:: media/exchange_rate06.png
+   :align: center
+
+Check if the **Currency** field is empty or in the foreign currency in which
+you will register the payments. If a currency is filled in, it means
+that you can register payments only in this currency.
+
+.. image:: media/exchange_rate10.png
+   :align: center
+
+Record a payment in a different currency
+========================================
+
+In the **Accounting** application, go to :menuselection:`Sales --> Payments`. 
+Register the payment and indicate that it was done in the foreign currency. Then
+click on **confirm**.
+
+.. image:: media/exchange_rate05.png
+   :align: center
+
+The journal entry has been posted but not allocated.
+
+Go back to your invoice (:menuselection:`Sales --> Customer Invoices`) and click on
+**Add** to allocate the payment.
+
+.. image:: media/exchange_rate04.png
+   :align: center
+
+Record a bank statement in a different currency
+===============================================
+
+Create or import the bank statement of your payment. The **Amount** is in
+the company currency. There are two complementary fields, the **Amount currency**, 
+which is the amount that was actually paid and the **Currency** in which it was paid.
+
+.. image:: media/exchange_rate07.png
+   :align: center
+
+When reconciling it, Odoo will directly match the payment with the right
+**Invoice**. You will get the invoice price in the invoice currency and the
+amount in your company currency.
+
+.. image:: media/exchange_rate09.png
+   :align: center
+
+Check the exchange rate differences
+===================================
+
+Go to :menuselection:`Adviser --> Journal Entries` and look for the **Exchange difference**
+journal entries. All the exchange rates differences are recorded in it.
+
+.. image:: media/exchange_rate01.png
+   :align: center
+
+.. tip::
+    The Exchange difference journal can be changed in your accounting settings.
+
+.. include:: full_reconcile_warning.rst
+
+.. seealso::
+    * :doc:`../../bank/reconciliation/configure`
+    * :doc:`../../bank/reconciliation/use_cases`

content/applications/finance/accounting/others/multicurrencies/full_reconcile_warning.rst

@@ -0,0 +1,7 @@
+.. warning::
+    In order for an exchange difference entry to be created automatically, the
+    corresponding invoices and payments need to be fully reconciled. This means
+    the invoices are fully paid and the payments are fully spent on invoices.
+    If you partially pay 3 invoices from 2 payments, and the last invoice still
+    has an amount due, there will be no exchange difference entry for any of
+    them until that final amount is paid.

content/applications/finance/accounting/others/multicurrencies/how_it_works.rst

@@ -0,0 +1,173 @@
+=====================================
+How is Odoo's multi-currency working?
+=====================================
+
+Overview
+========
+
+Choosing to use the multi-currency option in Odoo will allow you to send
+sales invoices, quotes and purchase orders or receive bills and payments
+in currencies other than your own. With multi-currency, you can also set
+up bank accounts in other currencies and run reports on your foreign
+currency activities.
+
+Configuration
+=============
+
+Turn on multi-currency
+----------------------
+
+In the accounting module, Go to :menuselection:`Configuration --> Settings` and flag
+**Allow multi currencies**, then click on **Apply**.
+
+.. image:: media/works01.png
+   :align: center
+
+Exchange Rate Journal
+---------------------
+
+The **Rate Difference Journal** records the differences between the payment
+registration and the expected amount. For example, if a payment is paid
+1 month after the invoice was issued, the exchange rate has probably
+changed. The fluctuation implies some loss or profit that are recorded
+by Odoo.
+
+You can change it in the settings:
+
+.. image:: media/works02.png
+   :align: center
+
+View or edit rate being used
+----------------------------
+
+You can manually configure the currency rates in :menuselection:`Configuration -->
+Currencies`. Open the currencies you want to use in Odoo and edit it.
+Make sure the currency is active.
+
+.. image:: media/works03.png
+   :align: center
+
+Click on **View Rates** to edit it and to see the history :
+
+.. image:: media/works04.png
+   :align: center
+
+Click on **Create** to add the rate. Fill in the date and the rate.
+Click on **Save** when you are done.
+
+.. image:: media/works05.png
+   :align: center
+
+Live Currency Rate
+------------------
+
+By default, the currencies need to be updated manually. But you can
+synchronize it with `Yahoo <https://finance.yahoo.com/currency-converter/>`__ or
+the `European Central Bank <http://www.ecb.europa.eu>`__. In 
+:menuselection:`Configuration --> Settings`, go to the **Live Currency Rate** section.
+
+Choose the interval : Manually, Daily, Weekly or Monthly. You can always
+force the update by clicking on **Update Now**. Select the provider, and you
+are set !
+
+.. image:: media/works06.png
+   :align: center
+
+.. note::
+
+	Only the **active** currencies are updated
+
+Configure your charts of account
+--------------------------------
+
+In the accounting application, go to :menuselection:`Adviser --> Charts of Accounts`.
+On each account, you can set a currency. It will force all moves for
+this account to have the account currency.
+
+If you leave it empty, it means that it can handle all currencies that
+are Active.
+
+.. image:: media/works07.png
+   :align: center
+
+Configure your journals
+-----------------------
+
+In order to register payments in other currencies, you have to remove
+the currency constraint on the journal. Go to the accounting
+application, Click on **More** on the journal and **Settings**.
+
+.. image:: media/works08.png
+   :align: center
+
+Check if the currency field is empty or in the foreign currency in which
+you will register the payments. If a currency is filled in, it means
+that you can register payments only in this currency.
+
+.. image:: media/works09.png
+   :align: center
+
+How is Odoo's multi-currency working?
+=====================================
+
+Now that you are working in a multi-currency environment, all
+accountable items will be linked to a currency, domestic or foreign.
+
+Sales Orders and Invoices
+-------------------------
+
+You are now able to set a different currency than the company one on
+your sale orders and on your invoices. The currency is set for the whole
+document.
+
+.. image:: media/works10.png
+   :align: center
+
+Purchases orders and Vendor Bills
+---------------------------------
+
+You are now able to set a different currency than the company one on
+your purchase orders and on your vendor bills. The currency is set for
+the whole document.
+
+.. image:: media/works11.png
+   :align: center
+
+Payment Registrations
+---------------------
+
+In the accounting application, go to **Sales > Payments**. Register the
+payment and set the currency.
+
+.. image:: media/works12.png
+   :align: center
+
+Bank Statements
+---------------
+
+When creating or importing bank statements, the amount is in the company
+currency. But there are now two complementary fields, the amount that
+was actually paid and the currency in which it was paid.
+
+.. image:: media/works13.png
+   :align: center
+
+When reconciling it, Odoo will directly match the payment with the right
+Invoice. You will get the invoice price in the invoice currency and the
+amount in your company currency.
+
+Exchange Rate Journal
+---------------------
+
+Go to :menuselection:`Adviser --> Journal Entries` and look for the Exchange difference
+journal entries. All the exchange rates differences are recorded in it.
+
+.. image:: media/works14.png
+   :align: center
+
+.. include:: full_reconcile_warning.rst
+
+.. seealso::
+
+	* :doc:`invoices_payments`
+	* :doc:`exchange`

content/applications/finance/accounting/others/multicurrencies/invoices_payments.rst

@@ -0,0 +1,122 @@
+========================================================
+How to manage invoices & payment in multiple currencies?
+========================================================
+
+Overview
+========
+
+Odoo provides multi-currency support with automatic currency gross or
+loss entry adjustment. There are a few things Odoo has been to ease the
+user's life.
+
+All the account transactions will be done using the company currency.
+However you can see two extra fields with the journal entry where
+secondary currency and amount will visible. You can create
+multi-currency journals of force a specific currency.
+
+When creating an invoice, the currency can be changed very easily;
+however Odoo takes the company currency as a default assignment. It will
+convert all the amounts automatically using that currency.
+
+Configuration
+=============
+
+Enable Multi-Currency
+---------------------
+
+For information about enabling Multi-Currency, please read the document:
+:doc:`how_it_works`
+
+Configure your journal
+----------------------
+
+In order to register payments in other currencies, you have to remove
+the currency constraint on the journal. Go to the accounting
+application, on the journal, click on :menuselection:`More --> Settings`.
+
+.. image:: media/invoice01.png
+   :align: center
+
+Check if the currency field is empty or in the foreign currency in which
+you will register the payments. If a currency is filled in, it means
+that you can register payments only in this currency.
+
+.. image:: media/invoice02.png
+   :align: center
+
+Multi-currency invoices & Vendor Bills
+======================================
+
+Now that you are working in a multi-currency environment, all
+accountable items will be linked to a currency, domestic or foreign.
+
+Invoices
+--------
+
+You are now able to set a different currency than the company one on
+your sale orders and on your invoices. The currency is set for the whole
+document.
+
+.. image:: media/invoice03.png
+   :align: center
+
+Vendor Bills
+------------
+
+You are now able to set a different currency than the company one on
+your purchase orders and on your vendor bills. The currency is set for
+the whole document.
+
+.. image:: media/invoice04.png
+   :align: center
+
+Multi-currency Payments
+=======================
+
+In the accounting application, go to :menuselection:`Sales --> Payments`. Register the
+payment and indicate that it was done in the foreign currency. Then
+click on **Confirm**.
+
+.. image:: media/invoice05.png
+   :align: center
+
+The journal entry has been posted but not allocated.
+
+Go back to your invoice (:menuselection:`Sales --> Customer Invoices`) and click on
+**Add** to allocate the payment.
+
+.. image:: media/invoice06.png
+   :align: center
+
+Multi- Currency Bank Statements
+===============================
+
+When creating or importing bank statements, the amount is in the company
+currency. But there are now two complementary fields, the amount that
+was actually paid and the currency in which it was paid.
+
+.. image:: media/invoice07.png
+   :align: center
+
+When reconciling it, Odoo will directly match the payment with the right
+invoice. You will get the invoice price in the invoice currency and the
+amount in your company currency.
+
+.. image:: media/invoice08.png
+   :align: center
+
+Exchange Rate Journal
+=====================
+
+Go to :menuselection:`Adviser --> Journal Entries` and look for the **Exchange
+Difference** journal entries. All the exchange rates differences are recorded in it.
+
+.. image:: media/invoice09.png
+   :align: center
+
+.. include:: full_reconcile_warning.rst
+
+.. seealso::
+	
+	* :doc:`how_it_works`
+	* :doc:`exchange`