On Fri, Jun 11, 2010 at 11:31 AM, Marnie McCormack <[email protected]> wrote: > Jonathan, > > Points 1, 2 & 3 - yes I agree. > > There are lots of people on this dev list who could opt in to help on the > docs for the Java side. I know why I don't have time - because the 0-10 > broker is taking #1 priority and represents a substantial investment in > Qpid.
Myself and Joanthan have taken care of the Java client to a certain extent. I am planning to add a few more docs there. Sadly I don't have enough knowledge on the Java broker side to review all the docs, but I will help where I can. > I'm not the 'plan' person for Qpid - I share what I'm doing/what I know is > going on. So I guess if there's not enough community input on the doc > migration thats a separate issue. I don't have time right now, but maybe > other people do ? > I don't really follow why you want to move the wiki URL - that would be > quite inconvenient for the links we use. I don't object to moving to the new > website, but I'd like to keep a reference to any docs that have not been > taken over. The current qpid.apache.org points to the old wiki. The community has voted to move to a new website which will occupy that URL. There will be a link from that website called "Wiki" which will point to the old wiki proper. Also from the documentation page we could point to the old java wiki docs in addition to the pdf/html versions. However I think it's good if all components use svn docs when we do the next release. The goal is to release html/pdf docs along with the bits. Hopefully the Java broker docs will be in a reasonable shape by then. > Marnie > > On Fri, Jun 11, 2010 at 3:09 PM, Jonathan Robie > <[email protected]>wrote: > >> On Fri, 2010-06-11 at 08:56 +0100, Marnie McCormack wrote: >> > Hi Jonathan, >> > >> > I'm not asking for updates on the wiki, but for it to stay up and linked >> to >> > until the docs have been converted from it/moved over. >> >> I think we agree that: >> >> 1. The Wiki needs to be kept available for archival purposes >> 2. It needs to be possible to link into the pages of the Wiki archives >> 3. We will not update the archives >> >> I think you're asking that we keep the archives precisely where they >> are, and not use qpid.apache.org for the new web site until the Java >> broker docs have been converted. I'd like to give the archived Wiki a >> URL that let's us reference it from the main qpid.apache.org pages, e.g. >> >> qpid.apache.org/wiki/archives >> >> I did an initial conversion of the Java broker docs months ago and have >> been asking for feedback and help. So far, no dice. Those converted docs >> are available on the new site, I'd be glad to point to the Wiki archives >> for the Java broker instead if you prefer. >> >> > The 0-10 broker implementation is the main priority for now and requiring >> > much effort, the docs will need to wait a while until thats in good >> shape. >> > Realistically, a few weeks more work on the broker I think. >> > I understand you want the java team to work on this - there are other >> Java >> > devs on this list who might have time to do this though ? >> > >> > From a time point of view, I'm not objecting to your plans just asking >> for >> > the wiki to stay put a while. >> >> Reading that, I don't hear any plan to have anyone do any work on the >> Java broker docs in any specified time frame. If nobody has done that in >> the last six months, what's going to change to make them do that now? >> >> The material in the Java broker docs I posted came directly from the >> Wiki, I tried to organize it a little. Ideally, I'd like someone to >> spend some time fixing that up and make it more usable, I spent time >> creating a book out of the Wiki documentation for the Java broker >> because I had hoped it would be helpful, but I'd also be happy to link >> to the Wiki archives for the Java broker docs instead. >> >> Jonathan >> >> >> --------------------------------------------------------------------- >> Apache Qpid - AMQP Messaging Implementation >> Project: http://qpid.apache.org >> Use/Interact: mailto:[email protected] >> >> > -- Regards, Rajith Attapattu Red Hat http://rajith.2rlabs.com/ --------------------------------------------------------------------- Apache Qpid - AMQP Messaging Implementation Project: http://qpid.apache.org Use/Interact: mailto:[email protected]
