On 03/16/2010 11:55 AM, Rajith Attapattu wrote:
On Tue, Mar 16, 2010 at 11:37 AM, Jonathan Robie
<[email protected]> wrote:
On 03/16/2010 11:13 AM, Rajith Attapattu wrote:
Here are some general comments.
Frankly I am not too happy with the current format.
That's fine - the current format was created in order to use existing Wiki
pages with as little modification as possible, with enough organization for
the sake of sanity.
My comments were about the existing format rather than the work you had done.
I think you have done excellent work in getting this off the ground !
I was aware that the first step was to get everything exported and
then take it from there.
I just wanted to make sure I sound my concerns early and decisively
before we move forward.
I want to know where we are heading, and move in that direction, rather than
polish what we have before setting goals. The most important thing right now
is to establish a common direction.
I'd like to see the following in the docs.
1. The user guide should be tied to a particular version, as we are
shipping them for each release.
Absolutely. And I think we need to start by setting a goal here. I propopose
that we aim to have up-to-date docs for release 7 - I can put the release
number on the front page.
The book is inherently tied to a qpid release by the fact that it is versioned
in subversion. It should pick up the release number from the build system
automatically. I can hack up a Makefile.am and CMakeLists.txt to build the book
and generate an XML fragment with the version in it - what should that XML
fragment look like?
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:[email protected]
