add docs.

Author: makasim

docs/bundle/message_producer.md

@@ -0,0 +1,51 @@
+# Message producer
+
+You can choose how to send messages either using a transport directly or with the client. 
+Transport gives you the access to all transport specific features so you can tune things where the client provides you with easy to use abstraction.
+ 
+## Transport
+ 
+```php
+<?php
+
+/** @var Symfony\Component\DependencyInjection\ContainerInterface $container */
+
+/** @var Enqueue\Psr\PsrContext $context */
+$context = $container->get('enqueue.transport.context');
+
+$context->createProducer()->send(
+    $context->createQueue('a_queue'),
+    $context->createMessage('Hello there!')
+);
+```
+
+## Client
+
+The client is shipped with two types of producers. The first one sends messages immediately 
+where another one (it is called spool producer) collects them in memory and sends them `onTerminate` event (the response is already sent).
+
+
+  
+```php
+<?php
+
+/** @var Symfony\Component\DependencyInjection\ContainerInterface $container */
+
+/** @var \Enqueue\Client\ProducerInterface $producer */
+$producer = $container->get('enqueue.producer');
+
+// message is being sent right now
+$producer->send('a_topic', 'Hello there!');
+
+
+/** @var \Enqueue\Client\SpoolProducer $spoolProducer */
+$spoolProducer = $container->get('enqueue.spool_producer');
+
+// message is being sent on console.terminate or kernel.terminate event
+$spoolProducer->send('a_topic', 'Hello there!');
+
+// you could send queued messages manually by calling flush method 
+$spoolProducer->flush();
+```
+
+[back to index](../index.md)

docs/index.md

@@ -25,6 +25,7 @@
     - [Quick tour](bundle/quick_tour.md)
     - [Config reference](bundle/config_reference.md)
     - [Cli commands](bundle/cli_commands.md)
+    - [Message producer](bundle/message_producer.md)
     - [Message processor](bundle/message_processor.md)
     - [Job queue](bundle/job_queue.md)
     - [Consumption extension](bundle/consumption_extension.md)