Robert Greig wrote:
2008/7/3 Jonathan Robie <[EMAIL PROTECTED]>:
Currently, the only documented Java API is Java JMS.
We also have a low-level Java API that has additional abilities and is more
similar to the APIs we have for other languages. Is it time to document this
low-level API in the tutorial?
I don't think the low level API should go in the tutorial. The low
level API is designed for the 1% of users who think they cannot
achieve what they want with the extended JMS API. It should be
documented, but we need to make clear to new users that for Java, the
JMS API is the way to go.
I agree with Robert (apart from the exact percentage, perhaps!).
I think clearly documenting how the JMS API maps onto AMQP, and perhaps
ultimately providing people with more control over how that is done,
would be valuable. I don't think presenting the low level API as an
alternative in the tutorial is the right way to go.
