cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Liguori (Created) (JIRA)" <j...@apache.org>
Subject [jira] [Created] (CXF-3841) Change "samples" folder to "examples"
Date Sun, 02 Oct 2011 21:01:35 GMT
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

        

Mime
View raw message