--- a/src/source/howto-paragraph.rst	Tue Jun 05 15:10:27 2018 +0200
+++ b/src/source/howto-paragraph.rst	Tue Jun 05 17:14:19 2018 +0200
@@ -4,13 +4,17 @@
 How to create a Paragraph type?
 ===============================
 
-Paragraphs are components or blocs that contain elements/fields and provide one or many renderer methods to compose
+Paragraphs or Blocks are components that contain elements/fields and provide one or many renderer methods to compose
 the front office website
 
-In this example we will create a contact paragraph to display at the user, who to contact
+
+Create a Paragraph
+""""""""""""""""""
 
-1) Define a paragraph Interface
--------------------------------
+In this example we will create a contact paragraph to display at the user, who to contact.
+
+1) Interface
+------------
 
 At first we create a new paragraph interface.
 
@@ -93,8 +97,9 @@
     :ref:`rendererhowto`
 
 
-How integrate a paragraph in the ZMI?
-=====================================
+Paragraph in the ZMI
+""""""""""""""""""""
+
 
 To display and manage the new paragraph in the ZMI, you should create this associated forms