Addressed @javiereguiluz comments

lrlopez · lrlopez · commit 7375b21c625a · 2016-04-13T23:07:45.000+02:00
diff --git a/components/property_access/introduction.rst b/components/property_access/introduction.rst
@@ -397,16 +397,16 @@ configuration files.
     <Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::setMetadataFactory>`
     see `Enable other Features`_.
 
-There are four method calls that can be overriden: `getter`, `setter`, `adder` and
-`remover`.
+There are four method calls that can be overriden: ``getter``, ``setter``, ``adder`` and
+``remover``.
 
-When using annotations you can precede a property with `@Property` to state which
+When using annotations you can precede a property with ``@Property`` to state which
 method should be called when a get, set, add or remove operation is needed on the
 property.
 
 .. configuration-block::
 
-    .. code-block:: php
+    .. code-block:: php-annotations
 
         // ...
         use Symfony\Component\PropertyAccess\Annotation\Property;
@@ -436,6 +436,7 @@ property.
 
     .. code-block:: yaml
 
+        # src/AppBundle/Resources/config/property_access.yml
         Person:
             name:
                 getter: getFullName
@@ -446,6 +447,7 @@ property.
 
     .. code-block:: xml
 
+        <!-- src/AppBundle/Resources/config/property_access.xml -->
         <?xml version="1.0" ?>
 
         <property-access xmlns="http://symfony.com/schema/dic/property-access-mapping"
@@ -472,8 +474,8 @@ Then, using the overriden methods is automatic:
     // will return 'Hello John Doe'
 
 You can also associate a particular method with an operation on a property
-using the `@PropertyGetter`, `@PropertySetter`, `@PropertyAdder` and
-`@PropertyRemover` annotations. All of them take only one parameter: `property`.
+using the ``@PropertyGetter``, ``@PropertySetter``, ``@PropertyAdder`` and
+``@PropertyRemover`` annotations. All of them take only one parameter: ``property``.
 
 This allows creating virtual properties that are not directly stored in the
 object:
@@ -550,10 +552,10 @@ Using property metadata with Symfony
 By default, Symfony will look for property metadata in the following places
 inside each bundle path:
 
-- `<Bundle path>/Resources/config/property_access.xml`
-- `<Bundle path>/Resources/config/property_access.yml`
-- `<Bundle path>/Resources/config/property_access/*.xml`
-- `<Bundle path>/Resources/config/property_access/*.yml`
+- ``<Bundle path>/Resources/config/property_access.xml``
+- ``<Bundle path>/Resources/config/property_access.yml``
+- ``<Bundle path>/Resources/config/property_access/*.xml``
+- ``<Bundle path>/Resources/config/property_access/*.yml``
 
 If you need getting metadata from annotations you must explicitly enable them:
 
