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 (Created) (JIRA)" <ji...@apache.org> on 2011/10/02 23:01:35 UTC

[jira] [Created] (CXF-3841) Change "samples" folder to "examples"

Change "samples" folder to "examples"
-------------------------------------

                 Key: CXF-3841
                 URL: https://issues.apache.org/jira/browse/CXF-3841
             Project: CXF
          Issue Type: Improvement
    Affects Versions: 2.4.2
            Reporter: Robert Liguori
            Priority: Trivial


CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something collected, and "examples" being generally thought of as something created.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

*** I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (CXF-3841) Change "samples" folder to "examples"

Posted by "Robert Liguori (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/CXF-3841?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Liguori updated CXF-3841:
--------------------------------

    Description: 
CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

*** I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

  was:
CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something collected, and "examples" being generally thought of as something created.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

*** I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

    
> Change "samples" folder to "examples"
> -------------------------------------
>
>                 Key: CXF-3841
>                 URL: https://issues.apache.org/jira/browse/CXF-3841
>             Project: CXF
>          Issue Type: Improvement
>    Affects Versions: 2.4.2
>            Reporter: Robert Liguori
>            Priority: Trivial
>
> CXF Projects: Samples vs Examples vs Demos
> Case Study:
> Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).
> Recommendation:
> Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".
> Justification:
> The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.
> * Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.
> Thanks for the consideration.
> Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.
> *** I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Commented] (CXF-3841) Change "samples" folder to "examples"

Posted by "Daniel Kulp (Commented) (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/CXF-3841?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13119115#comment-13119115 ] 

Daniel Kulp commented on CXF-3841:
----------------------------------


I'm -1 on this.   We've used samples for over 5 years and there is no compelling reason to change.   What other projects do should not matter for what we do so that whole argument is pointless.  I also don't get the whole collected/created thing.   

In anycase, I really don't see the point at all and the main thing it will cause is a lot of busy work updating wiki pages and documentation and stuff for no real value.
                
> Change "samples" folder to "examples"
> -------------------------------------
>
>                 Key: CXF-3841
>                 URL: https://issues.apache.org/jira/browse/CXF-3841
>             Project: CXF
>          Issue Type: Improvement
>    Affects Versions: 2.4.2
>            Reporter: Robert Liguori
>            Priority: Trivial
>
> CXF Projects: Samples vs Examples vs Demos
> Case Study:
> Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).
> Recommendation:
> Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".
> Justification:
> The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.
> * Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.
> Thanks for the consideration.
> Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.
> * I also recommend that Apache ActiveMQ changes their folder from "example" to "examples", for the same alignment purposes.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (CXF-3841) Change "samples" folder to "examples"

Posted by "Robert Liguori (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/CXF-3841?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Liguori updated CXF-3841:
--------------------------------

    Description: 
CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

* I also recommend that Apache ActiveMQ changes their folder from "example" to "examples", for the same alignment purposes.

  was:
CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

* I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

    
> Change "samples" folder to "examples"
> -------------------------------------
>
>                 Key: CXF-3841
>                 URL: https://issues.apache.org/jira/browse/CXF-3841
>             Project: CXF
>          Issue Type: Improvement
>    Affects Versions: 2.4.2
>            Reporter: Robert Liguori
>            Priority: Trivial
>
> CXF Projects: Samples vs Examples vs Demos
> Case Study:
> Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).
> Recommendation:
> Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".
> Justification:
> The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.
> * Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.
> Thanks for the consideration.
> Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.
> * I also recommend that Apache ActiveMQ changes their folder from "example" to "examples", for the same alignment purposes.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (CXF-3841) Change "samples" folder to "examples"

Posted by "Robert Liguori (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/CXF-3841?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Liguori updated CXF-3841:
--------------------------------

    Comment: was deleted

(was: Closing as undesired... I did notice the following though as another instance of the use of "examples"...

talend-sf-2.4.2.0/examples

;))
    
> Change "samples" folder to "examples"
> -------------------------------------
>
>                 Key: CXF-3841
>                 URL: https://issues.apache.org/jira/browse/CXF-3841
>             Project: CXF
>          Issue Type: Improvement
>    Affects Versions: 2.4.2
>            Reporter: Robert Liguori
>            Priority: Trivial
>
> CXF Projects: Samples vs Examples vs Demos
> Case Study:
> Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).
> Recommendation:
> Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".
> Justification:
> The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.
> * Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.
> Thanks for the consideration.
> Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.
> * I also recommend that Apache ActiveMQ changes their folder from "example" to "examples", for the same alignment purposes.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Updated] (CXF-3841) Change "samples" folder to "examples"

Posted by "Robert Liguori (Updated) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/CXF-3841?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Liguori updated CXF-3841:
--------------------------------

    Description: 
CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

* I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

  was:
CXF Projects: Samples vs Examples vs Demos

Case Study:
Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).

Recommendation:
Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".

Justification:
The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.

* Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.

Thanks for the consideration.

Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.

*** I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

    
> Change "samples" folder to "examples"
> -------------------------------------
>
>                 Key: CXF-3841
>                 URL: https://issues.apache.org/jira/browse/CXF-3841
>             Project: CXF
>          Issue Type: Improvement
>    Affects Versions: 2.4.2
>            Reporter: Robert Liguori
>            Priority: Trivial
>
> CXF Projects: Samples vs Examples vs Demos
> Case Study:
> Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).
> Recommendation:
> Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".
> Justification:
> The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.
> * Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.
> Thanks for the consideration.
> Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.
> * I also recommend that Apache ActiveMQ changes their folder from "example" to "examples".

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] [Closed] (CXF-3841) Change "samples" folder to "examples"

Posted by "Robert Liguori (Closed) (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/CXF-3841?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Robert Liguori closed CXF-3841.
-------------------------------

    Resolution: Not A Problem

Closing as undesired... I did notice the following though as another instance of the use of "examples"...

talend-sf-2.4.2.0/examples

;)
                
> Change "samples" folder to "examples"
> -------------------------------------
>
>                 Key: CXF-3841
>                 URL: https://issues.apache.org/jira/browse/CXF-3841
>             Project: CXF
>          Issue Type: Improvement
>    Affects Versions: 2.4.2
>            Reporter: Robert Liguori
>            Priority: Trivial
>
> CXF Projects: Samples vs Examples vs Demos
> Case Study:
> Apache ServiceMix and Apache Camel place their example projects under an "examples" folder.  Apache ActiveMQ uses an "example" folder (without the s).
> Recommendation:
> Rename CXF's "samples" folder to "examples". Specifically, change "\apache-cxf-2.4.2\samples" to "\apache-cxf-2.4.2\examples".
> Justification:
> The terms "Samples" and "Examples" are pretty much interchangeable, with the difference of "samples" being generally thought of as something *collected*, and "examples" being generally thought of as something *created*.  I believe that CXF example projects fall into the latter sub-classification.
> * Also, since CXF is in the same family as the other SOA-related tools that use "examples", this is another reason to align directory names.
> Thanks for the consideration.
> Some other use cases: Eclipse, XMLSpy and Tcl/TK use 'examples'. However, NetBeans and XMLBeans do use 'samples'.
> * I also recommend that Apache ActiveMQ changes their folder from "example" to "examples", for the same alignment purposes.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira