Hi, Radosław. This is great! I have a couple high-level comments. First, we should clarify what the intended scope of this is. From what I can tell, the content you have so far concerns the Qpid C++ broker and related admin tools. Qpid includes a number of other components (java broker, messaging apis, etc.), so we should say which are in play for this quick start.
Second, we should look at your documentation next to the C++ broker book's intro[1], which tries to serve a similar purpose. I think you've done a better job than the broker book of bubbling up the central aspects of broker usage. For me, this is an exercise in sorting the things you really want to know early on in your use of the broker from the things you can dive deep on later on. For example, a quick start should tell you how to perform some basic control over logging but it should not go into details such as category exclusion. The latter should be reserved for a dedicated logging section. [1] http://qpid.apache.org/releases/qpid-0.28/cpp-broker/book/ch01.html#section-Running-a-Qpid-CPP-Broker Justin On Mon, Aug 25, 2014 at 8:35 AM, Radosław Śmigielski < [email protected]> wrote: > Hi, > Qpid docs, seems to be missing "Quick Start Guide" type document. > I can say that from my personal perspective, person who 6 months > ago haven't had a clue such thing like qpid exists and needed to > quickly start with Qpid. To fill the gap I created draft of such > document, currently hosted on: > https://github.com/radeksm/qpid-quick-start > > Content of this document covers below points: > 1. Introduction > 2. Installation > 3. Configuration > 4. Running qpid > 5. Running qpid in HA > 6. Testing and troubleshooting > > Also here is a jira issue to track this: > https://issues.apache.org/jira/browse/QPID-6039 > > So following Alan Conway advice, he knows this document already > and advised me what to do next, I would like to ask Qpid Community > about feedback and review of this document by people who knows covered > areas better than I do. And maybe we can add this document to Qpid > documentation set at the end of this process. > > > ==================================================== > Radosław Śmigielski > ALCATEL-LUCENT - Cloudband/Node Team > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
