On Fri, Mar 27, 2009 at 8:25 PM, Greg Brown <[email protected]> wrote: >>> 2) Same question as above, but with the word "incubating". Is it ok >>> if our jar looks like "[apache-]pivot-wtk.jar", or must it be >>> "[apache-]pivot-wtk_incubating.jar"? >> >>Incubating MUST be part of the file names. > > Ugh. Is this really a requirement for the JARs themselves? The distribution > files are named > apache-pivot-1.1-incubating.zip/apache-pivot-1.1-incubating.tar.gz, and they > will ultimately live in a directory called > www.apache.org/dist/incubator/pivot. Appending "-incubating" to the names of > all of the JARs contained within the archives as well seems redundant, and it > will require updating all of our documentation, including our tutorials and > demos which currently include the JARs on their classpath. > > Niclas, you mentioned at one point that binaries are really just considered a > convenience for the end user - if this is true, does it really matter what > they are called, as long as they are packaged and distributed in such a way > that flags them clearly as "incubating"? Again, not trying to be contrary, > but I think that there are valid arguments to be made for leaving the naming > structure as-is (assuming that there are no legal implications).
The underlying principle is; The downstream user must not be confused and really be aware of that it is not an endorsed Apache release. Now, exactly where to draw the line is a tough nut to crack. My understanding of 'absolutes' are; - The source distribution MUST have "incubating" in the file name. - Any binary distribution MUST have 'incubating" in the file name. - Any binary, source or javadoc JAR that is distributed MUST have "incubating" in the version. Then after that we go into a gray zone, and I think sensible judgment and rationalization is better than hard fast rules. Cheers -- Niclas Hedhman, Software Developer http://www.qi4j.org - New Energy for Java I live here; http://tinyurl.com/2qq9er I work here; http://tinyurl.com/2ymelc I relax here; http://tinyurl.com/2cgsug
