diff --git a/partner_contact_job_position/README.rst b/partner_contact_job_position/README.rst
index f5169aa3c..c17511ef4 100644
--- a/partner_contact_job_position/README.rst
+++ b/partner_contact_job_position/README.rst
@@ -1,10 +1,10 @@
-.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
-   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+.. image:: https://img.shields.io/badge/license-AGPL--3-blue.png
+   :target: https://www.gnu.org/licenses/agpl
    :alt: License: AGPL-3
 
-====================
-Partner job position
-====================
+============================
+Partner Contact Job Position
+============================
 
 This module extends the functionality of partners job position to support
 having them categorized in tree form and allow you to choose a categorized job
@@ -16,7 +16,7 @@ Configuration
 
 To configure job positions, you need to:
 
-* Go to *Sales > Configuration > Address Book > Job Positions*.
+* Go to *Contacts > Configuration > Job Positions*.
 
 Usage
 =====
@@ -28,7 +28,7 @@ To use this module, you need to:
 
 .. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
    :alt: Try me on Runbot
-   :target: https://runbot.odoo-community.org/runbot/134/10.0
+   :target: https://runbot.odoo-community.org/runbot/134/11.0
 
 Bug Tracker
 ===========
@@ -36,15 +36,16 @@ Bug Tracker
 Bugs are tracked on `GitHub Issues
 <https://github.com/OCA/partner-contact/issues>`_. In case of trouble, please
 check there if your issue has already been reported. If you spotted it first,
-help us smashing it by providing a detailed and welcomed `feedback
-<https://github.com/OCA/
-partner-contact/issues/new?body=module:%20
-{module_name}%0Aversion:%20
-10.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
+help us smash it by providing detailed and welcomed feedback.
 
 Credits
 =======
 
+Images
+------
+
+* Odoo Community Association: `Icon <https://odoo-community.org/logo.png>`_.
+
 Contributors
 ------------
 
@@ -54,6 +55,9 @@ Contributors
 * Jairo Llopis <yajo.sk8@gmail.com>
 * David Vidal <david.vidal@tecnativa.com>
 
+Do not contact contributors directly about support or help with technical issues.
+
+
 Maintainer
 ----------
 
diff --git a/partner_contact_job_position/__init__.py b/partner_contact_job_position/__init__.py
index a51fa8070..e87e85c4c 100644
--- a/partner_contact_job_position/__init__.py
+++ b/partner_contact_job_position/__init__.py
@@ -1,7 +1,3 @@
-# -*- coding: utf-8 -*-
-# Copyright 2014 Pedro M. Baeza <pedro.baeza@tecnativa.com>
-# Copyright 2015 Antonio Espinosa <antonioea@antiun.com>
-# Copyright 2015 Jairo Llopis <jairo.llopis@tecnativa.com>
 # License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
 
 from . import models
diff --git a/partner_contact_job_position/__manifest__.py b/partner_contact_job_position/__manifest__.py
index 1940e0dfd..4380aa248 100644
--- a/partner_contact_job_position/__manifest__.py
+++ b/partner_contact_job_position/__manifest__.py
@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 # Copyright 2014 Pedro M. Baeza <pedro.baeza@tecnativa.com>
 # Copyright 2015 Antonio Espinosa <antonioea@antiun.com>
 # Copyright 2015 Jairo Llopis <jairo.llopis@tecnativa.com>
@@ -6,20 +5,17 @@
 # License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
 
 {
-    "name": "Partner job position",
+    "name": "Partner Job Position",
     "summary": "Categorize job positions for contacts",
-    "version": "10.0.1.0.1",
+    "version": "11.0.1.0.0",
     'category': 'Customer Relationship Management',
-    "website": "http://www.antiun.com",
-    'author': 'Serv. Tecnolog. Avanzados - Pedro M. Baeza, '
-              'Antiun Ingeniería S.L., '
-              'Tecnativa,'
+    "website": "https://github.com/OCA/partner-contact",
+    'author': 'Tecnativa,'
               "Odoo Community Association (OCA)",
     "license": "AGPL-3",
-    "application": False,
     "installable": True,
     "depends": [
-        "sale",
+        "contacts",
     ],
     "data": [
         'security/ir.model.access.csv',
diff --git a/partner_contact_job_position/models/__init__.py b/partner_contact_job_position/models/__init__.py
index 3d828f7b3..dc98b0254 100644
--- a/partner_contact_job_position/models/__init__.py
+++ b/partner_contact_job_position/models/__init__.py
@@ -1,7 +1,3 @@
-# -*- coding: utf-8 -*-
-# Copyright 2014 Pedro M. Baeza <pedro.baeza@tecnativa.com>
-# Copyright 2015 Antonio Espinosa <antonioea@antiun.com>
-# Copyright 2015 Jairo Llopis <jairo.llopis@tecnativa.com>
 # License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
 
 from . import res_partner
diff --git a/partner_contact_job_position/models/res_partner.py b/partner_contact_job_position/models/res_partner.py
index e43c62def..f16a4dccf 100644
--- a/partner_contact_job_position/models/res_partner.py
+++ b/partner_contact_job_position/models/res_partner.py
@@ -1,10 +1,9 @@
-# -*- coding: utf-8 -*-
 # Copyright 2014 Pedro M. Baeza <pedro.baeza@tecnativa.com>
 # Copyright 2015 Antonio Espinosa <antonioea@antiun.com>
 # Copyright 2015 Jairo Llopis <jairo.llopis@tecnativa.com>
 # License AGPL-3 - See http://www.gnu.org/licenses/agpl-3.0.html
 
-from odoo import models, fields
+from odoo import fields, models
 
 
 class ResPartner(models.Model):
diff --git a/partner_contact_job_position/readme/CONFIGURE.rst b/partner_contact_job_position/readme/CONFIGURE.rst
new file mode 100644
index 000000000..d96afd86c
--- /dev/null
+++ b/partner_contact_job_position/readme/CONFIGURE.rst
@@ -0,0 +1,7 @@
+To configure job positions, you need to:
+
+* Go to *Contacts > Configuration > Job Positions*.
+
+.. figure:: path/to/local/image.png
+   :alt: alternative description
+   :width: 600 px
diff --git a/partner_contact_job_position/readme/CONTRIBUTORS.rst b/partner_contact_job_position/readme/CONTRIBUTORS.rst
new file mode 100644
index 000000000..13acbdea0
--- /dev/null
+++ b/partner_contact_job_position/readme/CONTRIBUTORS.rst
@@ -0,0 +1,5 @@
+* Pedro M. Baeza <pedro.baeza@tecnativa.com>
+* Antonio Espinosa <antonioea@antiun.com>
+* Rafael Blasco <rafael.blasco@tecnativa.com>
+* Jairo Llopis <yajo.sk8@gmail.com>
+* David Vidal <david.vidal@tecnativa.com>
diff --git a/partner_contact_job_position/readme/DESCRIPTION.rst b/partner_contact_job_position/readme/DESCRIPTION.rst
new file mode 100644
index 000000000..5020ff16d
--- /dev/null
+++ b/partner_contact_job_position/readme/DESCRIPTION.rst
@@ -0,0 +1,4 @@
+This module extends the functionality of partners job position to support
+having them categorized in tree form and allow you to choose a categorized job
+position for your contacts in addition to the current custom string for job
+position.
diff --git a/partner_contact_job_position/readme/USAGE.rst b/partner_contact_job_position/readme/USAGE.rst
new file mode 100644
index 000000000..f108a29ac
--- /dev/null
+++ b/partner_contact_job_position/readme/USAGE.rst
@@ -0,0 +1,4 @@
+To use this module, you need to:
+
+* Go to any partner's form.
+* Use the new *Categorized job position* field.
diff --git a/partner_contact_job_position/views/res_partner_job_position_view.xml b/partner_contact_job_position/views/res_partner_job_position_view.xml
index 5326e9502..1a8e46a02 100644
--- a/partner_contact_job_position/views/res_partner_job_position_view.xml
+++ b/partner_contact_job_position/views/res_partner_job_position_view.xml
@@ -35,6 +35,6 @@
 
 <menuitem action="res_partner_job_position_action"
           id="menu_res_partner_job_position"
-          parent="sales_team.menu_config_address_book"/>
+          parent="contacts.res_partner_menu_config"/>
 
 </odoo>