add SonataAnnotationBundle to docs (#5041)

docs/cookbook/recipe_creating_an_admin_with_annotations.rst

@@ -0,0 +1,111 @@
+Creating an Admin with Annotations
+==================================
+
+If you are a fan of annotations, there is a 3rd party bundle that allows
+using annotations instead of creating admin classes.
+
+Download the SonataAnnotationBundle
+-----------------------------------
+
+Open a command console, enter your project directory and execute the
+following command to download the latest stable version of this bundle:
+
+.. code-block:: bash
+
+    $ composer require kunicmarko/sonata-annotation-bundle
+
+How to use
+----------
+
+Let's say we have a ``BlogPost`` entity that is connected to a ``Category`` entity
+like in the `getting started chapter`_:
+
+.. code-block:: php
+
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+    use KunicMarko\SonataAnnotationBundle\Annotation as Sonata;
+    // ...
+
+    /**
+     * @Sonata\Admin("BlogPost")
+     *
+     * @ORM\Table
+     * @ORM\Entity
+     */
+    class BlogPost
+    {
+        // ...
+
+        /**
+         * @Sonata\ListField()
+         * @Sonata\FormField()
+         *
+         * @ORM\Column(name="title", type="string")
+         */
+        private $title;
+
+        /**
+         * @Sonata\ListAssociationField(field="name")
+         * @Sonata\FormField()
+         *
+         * @ORM\ManyToOne(targetEntity="Category", inversedBy="blogPosts")
+         */
+        private $category;
+
+        // ...
+    }
+
+.. code-block:: php
+
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+    use KunicMarko\SonataAnnotationBundle\Annotation as Sonata;
+    // ...
+
+    /**
+     * @Sonata\Admin("Category")
+     *
+     * @ORM\Table
+     * @ORM\Entity
+     */
+    class Category
+    {
+        // ...
+
+        /**
+         * @Sonata\ListField()
+         * @Sonata\FormField()
+         *
+         * @ORM\Column(name="name", type="string")
+         */
+        private $name;
+
+        /**
+        * @ORM\OneToMany(targetEntity="BlogPost", mappedBy="category")
+        */
+        private $blogPosts;
+
+        // ...
+    }
+
+Do not forget to clear your cache:
+
+.. code-block:: bash
+
+    $ bin/console cache:clear
+
+You are done and you probably want to know how this looks like in the admin
+interface. Well, let's find out by going to http://localhost:8000/admin
+
+.. image:: ../images/admin_with_annotations.png
+   :align: center
+   :alt: Sonata Dashboard with SonataAnnotationBundle
+   :width: 700px
+
+The rest of the Annotation and their options can be found `here`_.
+
+.. _`getting started chapter`: https://sonata-project.org/bundles/admin/3-x/doc/getting_started/creating_an_admin.html
+.. _`here`: https://github.com/kunicmarko20/SonataAnnotationBundle#annotations

docs/index.rst

@@ -95,3 +95,4 @@ The demo website can be found at http://demo.sonata-project.org.
    cookbook/recipe_data_mapper
    cookbook/recipe_custom_view
    cookbook/recipe_persisting_filters
+   cookbook/recipe_creating_an_admin_with_annotations