change block doc to best practices

Author: dbu

bundles/block/create_your_own_blocks.rst

@@ -30,10 +30,10 @@ the location where the RSS feed should be shown. The easiest way is to extend
 free to do create your own document. At least, you have to implement
 ``Sonata\BlockBundle\Model\BlockInterface``. In your document, you
 need to define the ``getType`` method which returns the type name of your block,
-for instance ``acme_main.block.rss``::
+for instance ``block.rss``::
 
-    // src/Acme/MainBundle/Document/RssBlock.php
-    namespace Acme\MainBundle\Document;
+    // src/AppBundle/Document/RssBlock.php
+    namespace AppBundle\Document;
 
     use Doctrine\ODM\PHPCR\Mapping\Annotations as PHPCR;
 
@@ -56,7 +56,7 @@ for instance ``acme_main.block.rss``::
 
         public function getType()
         {
-            return 'acme_main.block.rss';
+            return 'block.rss';
         }
 
         public function getOptions()
@@ -97,8 +97,8 @@ services provided by the CmfBlockBundle are in the namespace
 For your RSS block, you need a custom service
 that knows how to fetch the feed data of an ``RssBlock``::
 
-    // src/Acme/MainBundle/Block/RssBlockService.php
-    namespace Acme\MainBundle\Block;
+    // src/AppBundle/Block/RssBlockService.php
+    namespace AppBundle\Block;
 
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\OptionsResolver\OptionsResolverInterface;
@@ -125,7 +125,7 @@ that knows how to fetch the feed data of an ``RssBlock``::
             $resolver->setDefaults(array(
                 'url'      => false,
                 'title'    => 'Feed items',
-                'template' => 'AcmeMainBundle:Block:rss.html.twig',
+                'template' => 'AppBundle:Block:rss.html.twig',
             ));
         }
 
@@ -308,33 +308,37 @@ handles, as per the ``getType`` method of the block. The second argument is the
 
     .. code-block:: yaml
 
-        sandbox_main.block.rss:
-            class: Acme\MainBundle\Block\RssBlockService
+        # app/config/services.yml
+        block.rss:
+            class: AppBundle\Block\RssBlockService
             arguments:
-                - "acme_main.block.rss"
+                - "block.rss"
                 - "@templating"
             tags:
                 - {name: "sonata.block"}
 
     .. code-block:: xml
 
-        <service id="sandbox_main.block.rss" class="Acme\MainBundle\Block\RssBlockService">
+        <!-- app/config/services.xml -->
+        <service id="sandbox_main.block.rss" class="AppBundle\Block\RssBlockService">
             <tag name="sonata.block" />
 
-            <argument>acme_main.block.rss</argument>
+            <argument>block.rss</argument>
             <argument type="service" id="templating" />
         </service>
 
     .. code-block:: php
 
+        // app/config/services.php
+
         use Symfony\Component\DependencyInjection\Definition;
         use Symfony\Component\DependencyInjection\Reference;
 
         $container
             ->addDefinition('sandbox_main.block.rss', new Definition(
-                'Acme\MainBundle\Block\RssBlockService',
+                'AppBundle\Block\RssBlockService',
                 array(
-                    'acme_main.block.rss',
+                    'block.rss',
                     new Reference('templating'),
                 )
             ))

bundles/block/introduction.rst

@@ -98,7 +98,7 @@ specific settings for one of the block classes.
         # app/config/config.yml
         sonata_block:
             blocks:
-                acme_main.block.news:
+                block.news:
                     settings:
                         maxItems: 3
             blocks_by_class:
@@ -113,7 +113,7 @@ specific settings for one of the block classes.
         <container xmlns="http://symfony.com/schema/dic/services">
 
             <config xmlns="http://sonata-project.com/schema/dic/block">
-                <blocks id="acme_main.block.rss">
+                <blocks id="block.rss">
                     <setting id="maxItems">3</setting>
                 </blocks>
                 <block-by-class class="Symfony\Cmf\Bundle\BlockBundle\Doctrine\Phpcr\RssBlock">
@@ -127,7 +127,7 @@ specific settings for one of the block classes.
         // app/config/config.php
         $container->loadFromExtension('sonata_block', array(
             'blocks' => array(
-                'acme_main.block.rss' => array(
+                'block.rss' => array(
                     'settings' => array(
                         'maxItems' => 3,
                     ),