diff --git a/README.rst b/README.rst
index a79348e..86a7db7 100644
--- a/README.rst
+++ b/README.rst
@@ -24,4 +24,4 @@ Now you can use python-docx-template to generate as many word documents you want
 Documentation
 -------------
 
-Please, read `http://docxtpl.readthedocs.org`_
\ No newline at end of file
+Please, `read the doc <http://docxtpl.readthedocs.org>`_
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index 20ff59c..d99f75a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -65,7 +65,7 @@ In order to manage paragraphs, table rows, runs, special syntax has to be used :
    {%r jinja2_tag %} for runs
 
 By using these tags, python-docx-template will take care to put the real jinja2 tags at the right place into the document's xml source code.
-In addition, these tags also tells python-docx-template to remove the paragraph, table row or run where are located the begin and ending tags.
+In addition, these tags also tells python-docx-template to remove the paragraph, table row or run where are located the begin and ending tags and only takes care about what is in between.
 
 Display variables
 .................