>>  - README doesn't mention our custom StAX distribution.
>
>Nope - only the pivot generated jars.

But the README does point out that you can get StAX from 
http://stax.codehaus.org. If we're referring users to codehaus.org, it seems 
like we should mention our custom JARs as well, and explain the modifications 
we made.

>>  - RELEASE_NOTES don't mention incomplete Compiler classes (should be
>>    listed along with TextArea).
>
>It's listed as such in the Javadoc for the class.

We had talked about adding it to the RELEASE_NOTES as well, since both TextArea 
and Compiler are included in this release but known to be incomplete.

>> - Reviewed decompressed artifact contents:
>>  - Should we be including the .graffle files (in project/design/) in the 
>> source
>>    distribution? I'd say no, since they are documentation, and we don't have 
>> any
>>    way to attach copyright info to them.
>
>In general, we should include the entire SVN contents in the source
>tree, so I'd say yes we should include them.  We don't have any way to
>attach copyright info to JPGs, yet we (and other projects) include
>them.

But we don't include any other documentation in our source distribution. I'd 
expect it to be omitted since it is not source and not required to compile or 
run the source. If we want to mirror SVN as closely as possible, I'd suggest 
that we remove it from the tag or remove it from SVN altogether.




Reply via email to