You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by Marnie McCormack <ma...@googlemail.com> on 2010/10/05 16:04:48 UTC
Qpid 0.8 Release - Documentation
Hi All,
So we're starting the countdown towards release. I wonder what we need to do
on the docs front and if it's integrated into the release/dist tools ?
Are other people's docs for 0.8 already in svn as part of the existing 0.7
docbook ?
I've got a couple of docs to put into the docbook, but been putting it off
for a while since I'm on windows and thus need to do some stuff, haven't got
there yet.
Thanks,
Marnie
Re: Qpid 0.8 Release - Documentation
Posted by Marnie McCormack <ma...@googlemail.com>.
Hi Jonathan,
Thanks for this info.
What I'm really asking about is 0.8 specific docs - i.e. have people written
docs for the content/features we wish to advertise as being highlights in
the 0.8 release ? And if not, now is the time ....
I'd agree it'd be good if all the Java committers could spend time on the
docbook. I've got some feature docs to add, but am short of time on the
overall piece - be great to see everyone pitch in here.
Thanks & Regards,
Marnie
On Tue, Oct 5, 2010 at 9:20 PM, Jonathan Robie <jo...@redhat.com>wrote:
> On 10/05/2010 10:04 AM, Marnie McCormack wrote:
>
>> Hi All,
>>
>> So we're starting the countdown towards release. I wonder what we need to
>> do
>> on the docs front and if it's integrated into the release/dist tools ?
>>
>> Are other people's docs for 0.8 already in svn as part of the existing 0.7
>> docbook ?
>>
>
> We already have the following in DocBook:
>
> - Programming in Apache Qpid
>
> http://qpid.apache.org/books/0.7/Programming-In-Apache-Qpid/html/index.html
> - AMQP Messaging Broker (Implemented in C++)
>
>
> http://qpid.apache.org/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/index.html
> - AMQP Messaging Broker (Implemented in Java)
>
>
> http://qpid.apache.org/books/0.7/AMQP-Messaging-Broker-Java-Book/html/index.html
>
> I have some material to contribute to the C++ broker book.
>
> The Java broker book is probably where you want to put some of the stuff
> you are writing. It can use some attention.
>
> The sources are in qpid/doc/book. The structure of the files is described
> in qpid/doc/book/README.txt.
>
>
>
> I've got a couple of docs to put into the docbook, but been putting it off
>> for a while since I'm on windows and thus need to do some stuff, haven't
>> got
>> there yet.
>>
>
> If you have something in Word format, Antiword can be helpful as a first
> conversion step. The following converts to DocBook format:
>
> $ antiword -xdb *.doc
>
> I'm available to help on this, if you need me. I think you have my phone
> number, if not, ask and I'll send it to you.
>
> Jonathan
>
> ---------------------------------------------------------------------
> Apache Qpid - AMQP Messaging Implementation
> Project: http://qpid.apache.org
> Use/Interact: mailto:dev-subscribe@qpid.apache.org
>
>
Re: Qpid 0.8 Release - Documentation
Posted by Jonathan Robie <jo...@redhat.com>.
On 10/05/2010 10:04 AM, Marnie McCormack wrote:
> Hi All,
>
> So we're starting the countdown towards release. I wonder what we need to do
> on the docs front and if it's integrated into the release/dist tools ?
>
> Are other people's docs for 0.8 already in svn as part of the existing 0.7
> docbook ?
We already have the following in DocBook:
- Programming in Apache Qpid
http://qpid.apache.org/books/0.7/Programming-In-Apache-Qpid/html/index.html
- AMQP Messaging Broker (Implemented in C++)
http://qpid.apache.org/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/index.html
- AMQP Messaging Broker (Implemented in Java)
http://qpid.apache.org/books/0.7/AMQP-Messaging-Broker-Java-Book/html/index.html
I have some material to contribute to the C++ broker book.
The Java broker book is probably where you want to put some of the stuff
you are writing. It can use some attention.
The sources are in qpid/doc/book. The structure of the files is
described in qpid/doc/book/README.txt.
> I've got a couple of docs to put into the docbook, but been putting it off
> for a while since I'm on windows and thus need to do some stuff, haven't got
> there yet.
If you have something in Word format, Antiword can be helpful as a first
conversion step. The following converts to DocBook format:
$ antiword -xdb *.doc
I'm available to help on this, if you need me. I think you have my phone
number, if not, ask and I'll send it to you.
Jonathan
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org