qpid-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jonathan Robie <jonathan.ro...@redhat.com>
Subject Re: Qpid Documentation page
Date Thu, 12 Feb 2009 20:15:18 GMT
Rafael Schloming wrote:
> Believe it or not I've never actually read our documentation, however 
> the controversy here inspired me to take a look, and now I feel the 
> need  to supply the perspective from a fresh set of eyes.
> Comparing just the two top level pages, I found the DocumentationB 
> page to be better organized. I felt like it was obvious how to find 
> the documentation for a given area.
> That said, when clicking down through the links underneath the general 
> portion, I have to agree that what is presented as the general FAQ is 
> really mostly about the C++ broker, and the How To guides seem buried 
> at the end of the FAQ page rather than being a top level link 
> underneath the respective brokers.

I agree.

> So my 2 cents would be keep the top level organization from 
> DocumentationB, but add the How To pages in as links underneath the 
> respective brokers, and pull most of the stuff from the "General" FAQ 
> into the C++ specific FAQ/HowTo page linked to from the C++ Broker 
> section.

If someone doesn't tell me to hold off, I'll be doing some of this kind 
of reorganization early next week.


Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org

View raw message