On Tue, 2010-06-08 at 08:37 -0400, Alan Conway wrote: > On 06/08/2010 08:13 AM, Jonathan Robie wrote: > > Here's the current version of the new web site: > > > > http://ci.apache.org/projects/qpid/ > > > > Does this seem basically right? What needs to happen before we make this > > live? > > > > Looks very nice. > > The getting started page has a link to the FAQ which links to the old cwiki. > The FAQ (and pages it links to) needs to move to the new site, but I don't > think > that needs to hold up putting this live as long as the links to the old pages > remain valid till they've been moved.
I'm inclined to move the old Wiki into a subdirectory and point to it, but not reflect further updates. The FAQ is a bit problematic because it pulls in pretty much everything, including things that belong to various versions that we no longer support, and it's not terribly well organized. I think we should probably create a new FAQ with current content, well organized, that contains mostly the responses to questions that are actually frequently asked. Perhaps we can start by identifying the FAQ entries that we want, and create a new FAQ using them. I also left out the road map, which currently goes up to M4. We need to create a new road map. I'll start a new thread on that ... There's other material that still needs to be converted - "Getting Involved" especially, it needs some reorganization at the same time, in my opinion. I'd like to move to the new site quickly, and move these things incrementally, reorganizing as we go. IMHO, the next big steps for me are to (1) work on the "getting involved" section, (2) get version numbers and stable link names into generated docs, (3) write a script to generate the entire site, including calls to epydoc and doxygen, docbook builds, and the wrapper (about half of this was done by hand this time around), and (4) dump material we've been planning to contribute into the C++ broker docs, concentrating on the 0.6 portion. I'd like to go forward, not backwards. The Java Broker docs need some massaging from the Java Broker team, I think. In Qpid 0.5, the C++ API docs didn't build for me cleanly using Doxygen. Those are the issues I'm aware of .... Jonathan --------------------------------------------------------------------- Apache Qpid - AMQP Messaging Implementation Project: http://qpid.apache.org Use/Interact: mailto:[email protected]
