fix readability for API

src/ORM/Entity.php

@@ -27,21 +27,22 @@ class Entity implements EntityInterface {
 
 /**
  * Initializes the internal properties of this entity out of the
- * keys in an array
- *
- * ### Example:
- *
- * ``$entity = new Entity(['id' => 1, 'name' => 'Andrew'])``
- *
- * @param array $properties hash of properties to set in this entity
- * @param array $options list of options to use when creating this entity
- * the following list of options can be used:
+ * keys in an array. The following list of options can be used:
  *
  * - useSetters: whether use internal setters for properties or not
  * - markClean: whether to mark all properties as clean after setting them
  * - markNew: whether this instance has not yet been persisted
  * - guard: whether to prevent inaccessible properties from being set (default: false)
  * - source: A string representing the alias of the repository this entity came from
+ *
+ * ### Example:
+ *
+ * {{{
+ * 	$entity = new Entity(['id' => 1, 'name' => 'Andrew'])
+ * }}}
+ *
+ * @param array $properties hash of properties to set in this entity
+ * @param array $options list of options to use when creating this entity
  */
 	public function __construct(array $properties = [], array $options = []) {
 		$options += [