<font face="trebuchet ms,sans-serif">Thanks Michael, interesting read.<br></font><br><div class="gmail_quote">On Tue, Aug 2, 2011 at 11:26, Michael Klishin <span dir="ltr"><<a href="mailto:michael.s.klishin@gmail.com">michael.s.klishin@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">I have a little announcement to make.<br><br>As I have been using RabbitMQ for over 2 years now, I kept explaining AMQP Model concepts, featurse & why they exist to numerous people. After a while it became clear that there is simply<br>
no decent introduction to the protocol. There are<br><br>* Shallow blog posts<br>* <a href="http://www.rabbitmq.com/faq.html#what-is-amqp" target="_blank">http://www.rabbitmq.com/faq.html#what-is-amqp</a> which does not really focus on explaining what AMQP has to offer (and, lets be honest, is written for CIOs/CTOs and not developers).<br clear="all">
* Full specification document<br><br>None of these options is really good in my opinion. The spec is pretty good at explaining what features AMQP has and why it has them but reading 40 page long specifications is not what most people want to do<br>
to learn the fundamentals. I also have no way to edit <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a> content.<br><br>So I decided to go ahead and write a 2 page long introduction that focumes on<br><br>* Concepts<br>
* Features<br>
* Why those features exist (what problems do they solve)<br>* Explaining what all those basic.get and queue.declare-ok really mean.<br><br>As a result we now have a new "AMQP 0.9.1 Model Explained" in the amqp gem documentation guides:<br>
<br><a href="http://bit.ly/amqp-model-explained" target="_blank">http://bit.ly/amqp-model-explained</a><br><br>I ran it by a few dozens of people with AMQP knowledge ranging from 0 (some of them are not really software engineers) to one of the RabbitMQ team members (Emile Joubert) and the feed back so far is<br>
"this is so much better than shallow blog posts, FAQs and 40 page long specifications". I intentionally left out some details that are irrelevant for understanding high-level protocol concepts.<br><br>This work is licensed it under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/" target="_blank">Creative Commons Attribution 3.0 Unported License</a> that lets RabbitMQ team take any parts of this guide, edit it and put it to <a href="http://rabbitmq.com" target="_blank">rabbitmq.com</a> (please concult with VMware legal department first but this is what Creative Commons site's "Choose a license" feature suggested me). The source is in Textile and up on github:<br>
<br><a href="https://github.com/ruby-amqp/amqp/blob/master/docs/AMQP091ModelExplained.textile" target="_blank">https://github.com/ruby-amqp/amqp/blob/master/docs/AMQP091ModelExplained.textile</a><br><br>I hope this helps with lowering the learning curve. I will keep refining that document and adding more diagrams when I have some more time.<br>
<br>Have a good day.<br><font color="#888888">-- <br>MK<br><br><a href="http://github.com/michaelklishin" target="_blank">http://github.com/michaelklishin</a><br><a href="http://twitter.com/michaelklishin" target="_blank">http://twitter.com/michaelklishin</a><br>
<br>
</font><br>_______________________________________________<br>
rabbitmq-discuss mailing list<br>
<a href="mailto:rabbitmq-discuss@lists.rabbitmq.com">rabbitmq-discuss@lists.rabbitmq.com</a><br>
<a href="https://lists.rabbitmq.com/cgi-bin/mailman/listinfo/rabbitmq-discuss" target="_blank">https://lists.rabbitmq.com/cgi-bin/mailman/listinfo/rabbitmq-discuss</a><br>
<br></blockquote></div><br>