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.
Jonathan
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:dev-subscr...@qpid.apache.org
