diff --git a/README.md b/README.md
deleted file mode 100644
index 9760efb9024..00000000000
--- a/README.md
+++ /dev/null
@@ -1,37 +0,0 @@
-
-[![Runboat](https://img.shields.io/badge/runboat-Try%20me-875A7B.png)](https://runboat.odoo-community.org/builds?repo=OCA/hr&target_branch=17.0)
-[![Pre-commit Status](https://github.com/OCA/hr/actions/workflows/pre-commit.yml/badge.svg?branch=17.0)](https://github.com/OCA/hr/actions/workflows/pre-commit.yml?query=branch%3A17.0)
-[![Build Status](https://github.com/OCA/hr/actions/workflows/test.yml/badge.svg?branch=17.0)](https://github.com/OCA/hr/actions/workflows/test.yml?query=branch%3A17.0)
-[![codecov](https://codecov.io/gh/OCA/hr/branch/17.0/graph/badge.svg)](https://codecov.io/gh/OCA/hr)
-[![Translation Status](https://translation.odoo-community.org/widgets/hr-17-0/-/svg-badge.svg)](https://translation.odoo-community.org/engage/hr-17-0/?utm_source=widget)
-
-<!-- /!\ do not modify above this line -->
-
-# hr
-
-TODO: add repo description.
-
-<!-- /!\ do not modify below this line -->
-
-<!-- prettier-ignore-start -->
-
-[//]: # (addons)
-
-This part will be replaced when running the oca-gen-addons-table script from OCA/maintainer-tools.
-
-[//]: # (end addons)
-
-<!-- prettier-ignore-end -->
-
-## Licenses
-
-This repository is licensed under [AGPL-3.0](LICENSE).
-
-However, each module can have a totally different license, as long as they adhere to Odoo Community Association (OCA)
-policy. Consult each module's `__manifest__.py` file, which contains a `license` key
-that explains its license.
-
-----
-OCA, or the [Odoo Community Association](http://odoo-community.org/), is a nonprofit
-organization whose mission is to support the collaborative development of Odoo features
-and promote its widespread use.
diff --git a/README.rst b/README.rst
new file mode 100644
index 00000000000..6a53f3ebfc2
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,99 @@
+=========================
+Employee external Partner
+=========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:8363c279df751b10a036d2e62af24096414927e7fc051a088569fe2d25e247b6
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fhr-lightgray.png?logo=github
+    :target: https://github.com/OCA/hr/tree/16.0/hr_employee_partner_external
+    :alt: OCA/hr
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/hr-16-0/hr-16-0-hr_employee_partner_external
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/hr&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Add the following fields to employee
+
+* is_external
+* hr_external_partner_id
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+Associates a Partner to an Employee to indicate that this Employee is administrated by
+the Partner but works in the Company.
+
+This Employee can be a real person or a "virtual" one: on second case is the Partner
+that defines the "real" person who works when requested.
+
+On Employees select an Employee and check option that he is an external,
+then associate the Partner.
+
+Changelog
+=========
+
+12.0.1.0.0 (2020-06-01)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+* [INI] Initial development
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/hr/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us to smash it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/hr/issues/new?body=module:%20hr_employee_partner_external%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+
+Do not contact contributors directly about support or help with technical issues.
+
+Credits
+=======
+
+Authors
+~~~~~~~
+
+* Stefano Consolaro Associazione PNLUG - Gruppo Odoo
+
+Contributors
+~~~~~~~~~~~~
+
+* Stefano Consolaro <stefano.consolaro@mymage.it>
+
+Maintainers
+~~~~~~~~~~~
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+This module is part of the `OCA/hr <https://github.com/OCA/hr/tree/16.0/hr_employee_partner_external>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.