diff --git a/README.md b/README.md
index 5c685a5..a48d202 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,12 @@
 # pydevd-odoo
-PyDev.Debugger plugin for Odoo
+
+[PyDev.Debugger](https://github.com/fabioz/PyDev.Debugger) is the Python debugger used
+in PyDev, PyCharm, VSCode. This plugin makes the debugger better for Odoo
+development.
+
+## Odoo Recordset
+[Recordsets](https://www.odoo.com/documentation/13.0/reference/orm.html#recordsets) is a fundamental concept in Odoo.
+A recordset is an ordered collection of records of the same model. Trying to read a field
+on multiple ids recordset will raise an error. Because PyDev.Debugger recognizes a recordset as a
+non-collection object so the error will be raise when evaluating its attributes. This plugin helps
+PyDev.Debugger correctly evaluate an multiple ids recordset.
\ No newline at end of file