You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@cxf.apache.org by "Robert Liguori (JIRA)" <ji...@apache.org> on 2010/10/01 18:12:34 UTC
[jira] Created: (CXF-3016) User guides alignment for Camel,
Servicemix, ActiveMQ, and CXF
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.
[jira] Commented: (CXF-3016) User guides alignment for Camel,
Servicemix, ActiveMQ, and CXF
Posted by "Hadrian Zbarcea (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CXF-3016?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12917129#action_12917129 ]
Hadrian Zbarcea commented on CXF-3016:
--------------------------------------
@Robert,
Great idea. We highly welcome contributions! You can start with the areas you're mostly interested in and I am sure the community will pitch in, wikipedia style.
> 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.
[jira] Commented: (CXF-3016) User guides alignment for Camel,
Servicemix, ActiveMQ, and CXF
Posted by "Glen Mazza (JIRA)" <ji...@apache.org>.
[ 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.
[jira] Commented: (CXF-3016) User guides alignment for Camel,
Servicemix, ActiveMQ, and CXF
Posted by "Robert Liguori (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CXF-3016?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12917139#action_12917139 ]
Robert Liguori commented on CXF-3016:
-------------------------------------
wiki access, isn't enabled by default for these pages... shouldn't it be?
How do I get access?
> 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.
[jira] Commented: (CXF-3016) User guides alignment for Camel,
Servicemix, ActiveMQ, and CXF
Posted by "Daniel Kulp (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CXF-3016?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12917143#action_12917143 ]
Daniel Kulp commented on CXF-3016:
----------------------------------
You need to submit an ICLA:
http://apache.org/licenses/icla.txt
and then we can enable write access.
> 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.
[jira] Resolved: (CXF-3016) User guides alignment for Camel,
Servicemix, ActiveMQ, and CXF
Posted by "Daniel Kulp (JIRA)" <ji...@apache.org>.
[ https://issues.apache.org/jira/browse/CXF-3016?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Daniel Kulp resolved CXF-3016.
------------------------------
Resolution: Invalid
Fix Version/s: Invalid
I'm marking this invalid for a couple reasons:
1) At Apache, each TLP is allowed (actually, kind of expected) to figure out how to present their web site in a way that best suites thier targets.
2) The navigations and such for CXF have been discussed in depth several times in the past on the dev list. We kind of like what we have.
3) If you don't like something in particular, a discussion on the dev list is more appropriate at this stage than a JIRA issue.
> 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
> Fix For: Invalid
>
> 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.