cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Glen Mazza (JIRA)" <j...@apache.org>
Subject [jira] Commented: (CXF-3016) User guides alignment for Camel, Servicemix, ActiveMQ, and CXF
Date Thu, 07 Oct 2010 09:52:31 GMT

    [ https://issues.apache.org/jira/browse/CXF-3016?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12918868#action_12918868
] 

Glen Mazza commented on CXF-3016:
---------------------------------

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

Which is absolutely fine, as each of the projects are separate from each other (each top-level)
with different committers on them.  The fact that many of the paid developers work for companies
that support multiple projects is irrelevant from the Apache perspective.  Further, each guide
is optimized to serve their particular product best.

quote: All of these products provide SOA related solutions.

But they are still so disparate that you cannot force them into the same format without loss
of data or unnatural/inefficient reading order.  What works for Camel does not work for CXF
and does not work for ActiveMQ.


> 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
>   Original Estimate: 240h
>  Remaining Estimate: 240h
>
> 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.


Mime
View raw message