[Docs] Make Plugin Development Guide more visible

docs/getting-started-with-sylius/plugin-installation.rst

@@ -36,5 +36,5 @@ Learn more
 ##########
 
 * :doc:`Plugins </plugins/index>`
-* :doc:`Plugin development guide </plugins/plugin-development-guide/index>`
+* :doc:`Plugin development guide </plugin-development-guide/index>`
 * :doc:`Official plugins </plugins/official-plugins>`

docs/index.rst

@@ -98,8 +98,7 @@ The Customization Guide
 Sylius Plugins
 --------------
 
-The collection of Sylius Plugins together with the guide on Plugins development.
-Remember that you can use all the :doc:`customization techniques </customization/index>` in Plugins.
+The collection of Sylius Plugins and basic introduction to the concept of plugins.
 
 .. toctree::
    :hidden:
@@ -108,6 +107,20 @@ Remember that you can use all the :doc:`customization techniques </customization
 
 .. include:: /plugins/map.rst.inc
 
+Plugin Development Guide
+------------------------
+
+If you're wondering how to share awesome features you have/want to have for Sylius with the Open Source community,
+here you will find a comprehensive guide to plugins development from the idea to sharing the plugin with the world.
+Remember that you can use all the :doc:`customization techniques </customization/index>` in Plugins.
+
+.. toctree::
+   :hidden:
+
+   plugin-development-guide/index
+
+.. include:: /plugin-development-guide/map.rst.inc
+
 The Cookbook
 ------------
 

docs/plugin-development-guide/index.rst

@@ -1,5 +1,5 @@
-Plugin Development Guide
-========================
+🏗️ Plugin Development Guide
+============================
 
 Sylius plugins are one of the most powerful ways to extend Sylius functionalities. They're not bounded by Sylius release cycle and can be
 developed quicker and more effectively. They also allow sharing our (developers) work in an open-source community, which is not possible with
@@ -9,7 +9,6 @@ BDD methodology says the most accurate way to explain some process is using an e
 With respect to that rule, let's create some simple first plugin together!
 
 .. toctree::
-   :numbered:
 
    idea
    installation
@@ -17,3 +16,10 @@ With respect to that rule, let's create some simple first plugin together!
    specification
    implementation
    summary
+
+.. seealso::
+
+    :doc:`/plugins/index`
+        The collection of Sylius Plugins and basic introduction to the concept of plugins.
+    :doc:`/customization/index`
+        Sylius customization techniques available to use also in plugins.

docs/plugin-development-guide/map.rst.inc

@@ -0,0 +1,7 @@
+* :doc:`/plugin-development-guide/index`
+* :doc:`/plugin-development-guide/idea`
+* :doc:`/plugin-development-guide/installation`
+* :doc:`/plugin-development-guide/naming`
+* :doc:`/plugin-development-guide/specification`
+* :doc:`/plugin-development-guide/implementation`
+* :doc:`/plugin-development-guide/summary`

docs/plugin-development-guide/summary.rst

@@ -5,7 +5,7 @@ Congratulations! You've created your first, fully tested and documented, customi
 
 As a result, you should see a new field in product variant form:
 
-.. image:: ../../_images/product_variant_available_on_demand.png
+.. image:: ../_images/product_variant_available_on_demand.png
     :align: center
 
 As you can see, there are some things to do at the beginning of development, but now, when you are already familiar with

docs/plugins/index.rst

@@ -15,13 +15,12 @@ Exemplary features may be: Social media buttons, newsletter, wishlists, payment
 
 .. tip::
 
-    **The list of all Sylius Plugins (offcial and approved) is available on the Sylius website** `here <http://sylius.com/developers/store/plugins>`_.
+    **The list of all Sylius Plugins (official and approved) is available on the Sylius website** `here <http://sylius.com/developers/store/plugins>`_.
 
 .. toctree::
     :hidden:
 
     creating-plugin
-    plugin-development-guide/index
     official-plugins
     approved-plugins
 

docs/plugins/map.rst.inc

@@ -1,4 +1,3 @@
 * :doc:`/plugins/creating-plugin`
-* :doc:`/plugins/plugin-development-guide/index`
 * :doc:`/plugins/official-plugins`
 * :doc:`/plugins/approved-plugins`