diff --git a/document_definition/README.rst b/document_definition/README.rst
index c97adfd9..18276b6c 100644
--- a/document_definition/README.rst
+++ b/document_definition/README.rst
@@ -2,18 +2,13 @@
     :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
     :alt: License: AGPL-3
 
-===================
-document_definition
-===================
+=====================
+Terms and definitions
+=====================
 
 Installs a new  document_definition model for dictionary-style word archive and
-definition. Searchable in the Knowledge menu.
-
-Known issues / Roadmap
-======================
-
-* A search function per term and per definition, obviously.
-* Dictionary Style Alphabetical grouping view
+definition. Adds Searchable view for terms and definitions in the Knowledge menu.
+Has a search view per term and per definition and a dictionary Style Alphabetical grouping view.
 
 Bug Tracker
 ===========
@@ -23,9 +18,6 @@ Bugs are tracked on `GitHub Issues
 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.
 
-Credits
-=======
-
 Images
 ------
 
diff --git a/document_definition/models/document_definition.py b/document_definition/models/document_definition.py
index a4934b1d..bb498101 100644
--- a/document_definition/models/document_definition.py
+++ b/document_definition/models/document_definition.py
@@ -7,7 +7,7 @@ from openerp import api, fields, models
 class DocumentDefinition(models.Model):
     _name = 'document.definition'
 
-    term = fields.Char(help='Term to define', required=True)
+    term = fields.Char(help='Term', required=True)
     definition = fields.Text(help='Definition of term', required=True)
 
     # stored compute field used for making the letter grouping
@@ -15,7 +15,7 @@ class DocumentDefinition(models.Model):
     first_letter = fields.Char()
 
     def _get_first_letter(self, text):
-        # if somehow the user starts with a blank space we trim it
+        # if somehow the user starts with one or more whitespaces we trim
         return text.lstrip()[:1].upper() or 'Blank Term'
 
     @api.model