diff -r ae0e104800aa -r 88a65b19d07d src/source/howto-paragraph.rst
--- a/src/source/howto-paragraph.rst	Mon Jun 04 14:14:41 2018 +0200
+++ b/src/source/howto-paragraph.rst	Mon Jun 04 14:31:01 2018 +0200
@@ -1,7 +1,7 @@
 .. _paragraphhowto:
 
 
-How to create a new paragraph type?
+How to create a new Paragraph type?
 ===================================
 
 Paragraphs are components or blocs that contain elements/fields and provide one or many renderer methods to compose
@@ -74,7 +74,7 @@
                 alsoProvides(self._photo, IResponsiveImage)
 
 
-3) renderers Vocabulary
+3) Renderers Vocabulary
 ----------------------
 
 The list of rendered available for a paragraph is build automatically and is based on adapters that provide this interface
@@ -198,6 +198,7 @@
 ---------------------------------
 
 .. code-block:: python
+
     @adapter_config(context=(IContactPhoneParagraph, IPyAMSLayer), provides=IParagraphInnerEditor)
     @implementer(IInnerForm)
     class ContactPhoneParagraphInnerEditForm(ContactPhoneParagraphPropertiesEditForm):