[rabbitmq-discuss] Improving our documentation
mikeb at rabbitmq.com
Mon Nov 22 17:24:58 GMT 2010
Jiri, thanks for your comments --
now? I'll update the tutorial text too.
> Regarding the Java examples, in my opinion the following is a bit unusual:
> - Java classes usually start with an uppercase letter.
I thought I'd get away with that one ..
> - Connection.close() should be probably called from a finally block.
This is a bit awkward, because (as it sends frames over the connection)
Connection.close() can throw an IOException. We may clean this up a bit
by providing a closeQuietly().
> - Should recv.java really have an infinite loop?
It doesn't hurt, in our "Hello World" -- the nextDelivery() blocks.
> - When handling an exception, one should print all the available info
> before swallowing it - for example using e.printStackTrace().
Yes you're right, that is more idiomatic (and helpful).
>> Back in October, Marek announced that we had started work on some
>> tutorials for RabbitMQ .
>> I am very pleased to be able to let everyone know that the first "Get
>> Started" tutorials have gone live on the RabbitMQ website today. Thank
>> to everyone who provided comments and feedback - please keep them coming.
>> The tutorials are available at:
>> This is by no means the end of the work we are doing to make our
>> documentation better so expect to see more improvements over the coming
>> weeks and months. If you have any ideas about what you would like to see
>> (or, indeed, what you wouldn't) then please let us know.
> rabbitmq-discuss mailing list
> rabbitmq-discuss at lists.rabbitmq.com
More information about the rabbitmq-discuss