User guides alignment for Camel, Servicemix, ActiveMQ, and CXF 
---------------------------------------------------------------

                 Key: CXF-3016
                 URL: https://issues.apache.org/jira/browse/CXF-3016
             Project: CXF
          Issue Type: Improvement
          Components: Documentation
            Reporter: Robert Liguori
            Priority: Minor


Consider the following users guide URLs of Camel, Servicemix, ActiveMQ, and CXF 

http://servicemix.apache.org/users-guide.html
http://camel.apache.org/user-guide.html
http://cxf.apache.org/docs/index.html
http://activemq.apache.org/getting-started.html

All of these products provide SOA related solutions.

Each one of the user guides appear to have been developed independent of the 
other related product's guides.

It would be nice if they had the same feel and content structure.  Note: Of 
course each would have sections related to info that is unique to them.

I'm basically suggesting that a similair table of contents exists for each user 
guide, with the subcontents created/refined in a quality-controlled manner.

This would require someone comparing all four user guides, and bringing them 
into alignment.  The exercise will be valuable as it will expose missing 
sections of each user guide and will encourage the hyperlinking of informaiton 
where necessary.

In the long run, the existing, valuable user guides would be refined to produce 
four top quality user guides; one for each product: Camel, Servicemix, 
ActiveMQ, and CXF 

Please take this request under strong consideration.
  





-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to