diff --git a/html_text/README.rst b/html_text/README.rst
index 2b53f8388..d740940ae 100644
--- a/html_text/README.rst
+++ b/html_text/README.rst
@@ -24,7 +24,6 @@ examples and read the docs inside the code.
 
 Python example::
 
-    @api.multi
     def some_method(self):
         # Get truncated text from an HTML field. It will 40 words and 100
         # characters at most, and will have "..." appended at the end if it
diff --git a/html_text/__manifest__.py b/html_text/__manifest__.py
index 88f39b3d7..4438a7700 100644
--- a/html_text/__manifest__.py
+++ b/html_text/__manifest__.py
@@ -4,7 +4,7 @@
 {
     "name": "Text from HTML field",
     "summary": "Generate excerpts from any HTML field",
-    "version": "12.0.1.0.0",
+    "version": "13.0.1.0.0",
     "category": "Tools",
     "website": "https://github.com/OCA/server-tools",
     "author": "Grupo ESOC Ingeniería de Servicios, "
@@ -14,6 +14,6 @@
     "license": "AGPL-3",
     "application": False,
     "installable": True,
-    "external_dependencies": {"python": ["lxml",],},
-    "depends": ["base",],
+    "external_dependencies": {"python": ["lxml"]},
+    "depends": ["base"],
 }
diff --git a/html_text/readme/CONTRIBUTORS.rst b/html_text/readme/CONTRIBUTORS.rst
new file mode 100644
index 000000000..07e67237b
--- /dev/null
+++ b/html_text/readme/CONTRIBUTORS.rst
@@ -0,0 +1,6 @@
+* Dennis Sluijk <d.sluijk@onestein.nl>
+* `Tecnativa <https://www.tecnativa.com>`_:",
+
+  * Jairo Llopis
+  * Vicent Cubells
+  * Víctor Martínez
diff --git a/html_text/readme/DESCRIPTION.rst b/html_text/readme/DESCRIPTION.rst
new file mode 100644
index 000000000..579fd7667
--- /dev/null
+++ b/html_text/readme/DESCRIPTION.rst
@@ -0,0 +1,7 @@
+This module provides some technical features that allow to extract text from
+any chunk of HTML, without HTML tags or attributes. You can chose either:
+
+* To truncate the result by amount of words or characters.
+* To append an ellipsis (or any character(s)) at the end of the result.
+
+It can be used to easily generate excerpts.
diff --git a/html_text/readme/ROADMAP.rst b/html_text/readme/ROADMAP.rst
new file mode 100644
index 000000000..0a77fddef
--- /dev/null
+++ b/html_text/readme/ROADMAP.rst
@@ -0,0 +1,2 @@
+* An option could be added to try to respect the basic HTML tags inside the
+  excerpt (``<b>``, ``<i>``, ``<p>``, etc.).
diff --git a/html_text/readme/USAGE.rst b/html_text/readme/USAGE.rst
new file mode 100644
index 000000000..ae34a9b25
--- /dev/null
+++ b/html_text/readme/USAGE.rst
@@ -0,0 +1,21 @@
+This module just adds a technical utility, but nothing for the end user.
+
+If you are a developer and need this utility for your module, see these
+examples and read the docs inside the code.
+
+Python example::
+
+    def some_method(self):
+        # Get truncated text from an HTML field. It will 40 words and 100
+        # characters at most, and will have "..." appended at the end if it
+        # gets truncated.
+        truncated_text = self.env["ir.fields.converter"].text_from_html(
+            self.html_field, 40, 100, "...")
+
+QWeb example::
+
+    <t t-esc="env['ir.fields.converter'].text_from_html(doc.html_field)"/>
+
+.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
+   :alt: Try me on Runbot
+   :target: https://runbot.odoo-community.org/runbot/149/11.0
diff --git a/html_text/tests/test_extractor.py b/html_text/tests/test_extractor.py
index d81b88765..1f0b7c91c 100644
--- a/html_text/tests/test_extractor.py
+++ b/html_text/tests/test_extractor.py
@@ -7,7 +7,7 @@ from odoo.tools import mute_logger
 
 class ExtractorCase(TransactionCase):
     def setUp(self):
-        super(ExtractorCase, self).setUp()
+        super().setUp()
         # Shortcut
         self.text_from_html = self.env["ir.fields.converter"].text_from_html
 
@@ -24,7 +24,6 @@ class ExtractorCase(TransactionCase):
                 </body>
             </html>
             """
-
         self.assertEqual(
             self.text_from_html(html),
             u"I'm a title I'm a paragraph ¡Pues yo soy español!",