More concrete examples and slightly more self-contained documentation

Author: jonathonwalz

bundles/create/configuration.rst

@@ -72,16 +72,16 @@ For more information, see the
 You can specify a service implementing ``Midgard\CreatePHP\RdfMapperInterface``
 that will handle objects that need to be stored by the REST handler of
 CreatePHP. You need to either specify this service, enable phpcr or orm
-persistence or provide a ``cmf_create.mapper`` tagged mapper for this
-bundle to work.
+persistence or define one or more services that implement the
+``Midgard\CreatePHP\RdfChainableMapperInterface`` and tag them with ``cmf_create.mapper``.
 
 .. _config-create-persistence:
 
 ``persistence``
 ~~~~~~~~~~~~~~~
 
-This defines the persistence driver and associated classes. The default
-persistence configuration has the following configurations.
+This defines a persistence driver for Doctrine PHPCR-ODM documents or Doctrine ORM entities.
+If you specify neither, see :ref:`config-create-object-mapper-service-id`.
 
 ``phpcr``
 .........
@@ -91,7 +91,6 @@ persistence configuration has the following configurations.
     .. code-block:: yaml
 
         cmf_create:
-            object_mapper_service_id: ~
             persistence:
                 phpcr:
                     enabled:      false
@@ -181,7 +180,6 @@ your content is gone.
     .. code-block:: yaml
 
         cmf_create:
-            object_mapper_service_id: ~
             persistence:
                 orm:
                     enabled:      false

bundles/create/introduction.rst

@@ -256,7 +256,7 @@ routing configuration to enable the REST end point for saving content:
         $collection->addCollection($loader->import("@CmfCreateBundle/Resources/config/routing/rest.xml"));
 
         return $collection;
-        
+
 .. tip::
 
     If you don't want these routes to be prefixed by the current locale, you can
@@ -515,36 +515,41 @@ domain objects. Data needs to be stored back into the database.
     The chain mapper and ORM configuration was introduced in CreateBundle
     1.3. Prior, only the PHPCR-ODM mapper was available.
 
+Adding Custom Mappers to the Chain
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 The CreateBundle provides a chain mapper service that supports multiple mappers.
 Mappers for Doctrine PHPCR-ODM and Doctrine ORM are provided and can be enabled
 via :ref:`persistence configuration <config-create-persistence>`.
 
-You may provide mappers to the chain mapper in addition to or in place of the
-provided mappers. They must implement ``Midgard\CreatePHP\RdfChainableMapperInterface``
-and be tagged with ``create_cmf.mapper``.
+You may provide mappers to the chain mapper in addition to or in place of
+the provided mappers. They must implement ``Midgard\CreatePHP\RdfChainableMapperInterface``
+and be tagged with ``create_cmf.mapper``. You may provide the tag with an
+alias which will be prepended to subjects, the RDFa about field. If an alias
+is not provided, the service's id will be used instead.
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         services:
-            acme_core.my_mapper:
-                class: "%my_namespace.my_mapper_class%"
+            app.elasticsearch_mapper:
+                class: "AppBundle\Mapper\ElasticSearchMapper"
                 tags:
-                    - { name: create_cmf.mapper, alias: my_mapper_alias }
+                    - { name: create_cmf.mapper, alias: elasticsearch }
 
     .. code-block:: xml
 
-        <service id="acme_core.my_mapper" class="%my_namespace.my_mapper_class%">
-            <tag name="create_cmf.mapper" alias="my_mapper_alias" />
+        <service id="app.elasticsearch_mapper" class="AppBundle\Mapper\ElasticSearchMapper">
+            <tag name="create_cmf.mapper" alias="elasticsearch" />
             <!-- ... -->
         </service>
 
     .. code-block:: php
 
         $container
-            ->register('acme_core.my_mapper', '%my_namespace.my_mapper_class')
-            ->addTag('create_cmf.mapper', array('alias' => 'my_mapper_alias'))
+            ->register('app.elasticsearch_mapper', 'AppBundle\Mapper\ElasticSearchMapper')
+            ->addTag('create_cmf.mapper', array('alias' => 'elasticsearch'))
         ;
 
 You may instead set :ref:`config-create-object-mapper-service-id` and use