[
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.
