First draft of docs folder

docs/add_custom_sorts.md

@@ -0,0 +1 @@
+@TODO

docs/add_custom_values.md

@@ -0,0 +1,58 @@
+# Add custom values to your indexed entity
+
+## Add custom value for a product
+
+In our example we will add the `short_description` product field to the indexed content.
+
+First, declares your services : 
+
+```yaml
+    App\Search\EventListener\AppendProductMappingSubscriber:
+        autoconfigure: true
+
+    App\Search\Automapper\DecorateProductMapperConfiguration:
+        autowire: true
+        decorates: MonsieurBiz\SyliusSearchPlugin\AutoMapper\ProductMapperConfiguration
+        arguments:
+            - '@.inner'
+```
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Search\EventListener;
+
+use MonsieurBiz\SyliusSearchPlugin\Event\MappingProviderEvent;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+
+final class AppendProductMappingSubscriber implements EventSubscriberInterface
+{
+    public static function getSubscribedEvents(): array
+    {
+        return [
+            MappingProviderEvent::EVENT_NAME => 'onMappingProvider',
+        ];
+    }
+
+    public function onMappingProvider(MappingProviderEvent $event): void
+    {
+        // We work on products, ignore the rest
+        if ('monsieurbiz_product' !== $event->getIndexCode()) {
+            return;
+        }
+
+        $mapping = $event->getMapping();
+        if (null === $mapping || !$mapping->offsetExists('mappings')) {
+            return;
+        }
+
+        $mappings['properties']['short_description'] = [
+            'type' => 'text',
+        ];
+
+        $mapping->offsetSet('mappings', $mappings);
+    }
+}
+```

docs/index.md

@@ -0,0 +1,10 @@
+# SyliusSearchPlugin
+
+@TODO Description
+
+## Menu
+
+- [Add custom sorts](./add_custom_sorts.md)
+- [Add custom values](./add_custom_values.md)
+- [Index custom entities](./index_custom_entities.md)
+- [Nested fields limit](./nested_fields_limit.md)

docs/index_custom_entities.md

@@ -0,0 +1 @@
+@TODO

docs/nested_fields_limit.md

@@ -0,0 +1,37 @@
+@TODO
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Search\EventListener;
+
+use MonsieurBiz\SyliusSearchPlugin\Event\MappingProviderEvent;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+
+final class AppendProductMappingSubscriber implements EventSubscriberInterface
+{
+    public static function getSubscribedEvents(): array
+    {
+        return [
+            MappingProviderEvent::EVENT_NAME => 'onMappingProvider',
+        ];
+    }
+
+    public function onMappingProvider(MappingProviderEvent $event): void
+    {
+        if ('monsieurbiz_product' !== $event->getIndexCode()) {
+            return;
+        }
+
+        $mapping = $event->getMapping();
+        if (null === $mapping || !$mapping->offsetExists('mappings')) {
+            return;
+        }
+
+        $settings = $mapping->offsetGet('settings') ?? [];
+        $mapping->offsetSet('settings', array_merge($settings, ['mapping.nested_fields.limit' => 100])); // Increase the limit of nested fields
+    }
+}
+```