Looking at the rat report now. I'll edit it direct if that's appropriate. KElvin.
On 18/01/2008, Amita Vadhavkar <[EMAIL PROTECTED]> wrote: > > Thanks Kelvin, will look at all these points. Also, > I used rat-5.0.jar and got the report at - > http://cwiki.apache.org/confluence/display/TUSCANYWIKI/RAT+Report > Please see "Unresolved" section in it and give comments about what is > appropriate to fix there. > > Regards, > Amita > > On Jan 18, 2008 3:56 PM, kelvin goodson <[EMAIL PROTECTED]> wrote: > > > On 18/01/2008, Amita Vadhavkar <[EMAIL PROTECTED]> wrote: > > > > > > Assuming name of the release as Tuscany SDO Java 1.1-incubating and > > > keeping > > > ref. to the > > > old mail thread - > > > http://www.mail-archive.com/[EMAIL PROTECTED]/msg27168.html. > > > I am starting a new thread now. > > > > > > Web Site documentation:- I could gather a few places where small > updates > > > can > > > be done. Please give your comments > > > if these seem fine or need something more/something else. > > > > > > 1) why on > > http://incubator.apache.org/tuscany/sdo-java-get-involved.htmlwe > > > have - > > > Open CSA (SCA Standards) > > > > > > This is confusing and needs investigating. I think you are talking > about > > the transition from ... > > http://incubator.apache.org/tuscany/sdo-java.html > > to > > http://incubator.apache.org/tuscany/sdo-java-get-involved.html > > > > In which case the "Get Involved" is a link from the "general" menu and > > therefore is general to Tuscany. However, the page is entitled "SDO > > Java > > Get Involved", yet seems identical to the "Get Involved" page from the > > Tuscany Home page's Community menu apart from the fact that this page is > > entitled "Getting Involved: Apache Tuscany". I'm sure we used to have > our > > own SDO Java getting involved page, and I think it has accidentally > been > > overwritten at some stage. I guess we need to look at the wiki change > > history and see if we can recover it. > > > > 2) changes in > > > http://incubator.apache.org/tuscany/tuscany-sdo-java-faq.htmlfor > > > new features, improvements > > > > > > I'm a bit confused here. I think maybe you have two separate ideas that > > have been merged perhaps. I don't think we want to detail new features > on > > the FAQ page. > > > > TUSCANY-1468 - Use HelperContext for scope in Tuscany API > > > TUSCANY-1128 - Support attribute and element with same name > > > TUSCANY-1359 - New SDOUtil: Upper and lower bound on properties where > > > 'isMany' is true > > > CTS TUSCANY-1230 - Improvements to TypeConversionTest > > > > > > Something I meant to mention in regards to your other posting is that > the > > CTS is not part of an SDO Java release. We haven't ever "released" the > > CTS, since it's never yet seemed to make sense to do so. SDO > > implementers > > who want to use the CTS can download the source. I think what we want > to > > do > > here is a respin of the kind of release we have done before, for the > SDO > > Java runtime. > > > > Is there anything else from > > > > http://cwiki.apache.org/confluence/display/TUSCANYWIKI/SDO+Java+Project > > > that can be added to it? Also do the above mentioned JIRAs useful as > > part > > > of > > > FAQ, or mention in Release Notes will > > > be sufficient? > > > > > > I see now. Yes, release notes are definitely the place for this. > > > > 3) http://incubator.apache.org/tuscany/tuscany-sdo-java-faq.html page > does > > > not have menu > > > > > > Good point > > > > 4) http://incubator.apache.org/tuscany/sdo-project-code-structure.htmlno > > > menu , old structure > > > > > > you are right, we need to add a section for the lib project and the > > tools-test project > > > > 5) http://incubator.apache.org/tuscany/getting-source.html no menu and > old > > > structure > > > > > > again, yes, this doesn't reflect the move of the api project into the > > main > > sdo trunk > > > > 6) developer guide - should we refer to > > > http://incubator.apache.org/tuscany/sca-java-development-guide.htmland > > > make SDO Dev Guide more complete? > > > > > > I think ideally we would incorporate some of the new content from the > sca > > guide into an sdo guide. If the SCA guide is built up by wiki include > > directives, there may be scope for including generic chunks into out own > > guide. > > > > 7) http://incubator.apache.org/tuscany/sdo-java-user-guide.html again no > > > menu > > > can refer to > > http://incubator.apache.org/tuscany/sca-java-user-guide.html > > > > > > 8) TUSCANY-1026 > > > Also, why > > > > > > > > > https://svn.apache.org/repos/asf/incubator/tuscany/java/sdo/distribution/src/main/release/bin/samples/sampleProgramContents.html > > > opens the html page without browser rendering it as html? (like shows > > all > > > html tags etc.) > > > > > > I think this is a firefox issue. It's fine in IE. Not sure why it's > wrong > > in firefox though. > > > > Can we provide this link in > > > http://incubator.apache.org/tuscany/sdo-java-user-guide.html > > > > > > This looks like a useful rework of some of the content that I think is > > already in the site. It certainly was at one time. > > > > 9) TUSCANY-1531 > > > From this - comment #1 - Some pages are only available on the left > menu > > on > > > this page : > http://incubator.apache.org/tuscany/developing-sdo-java.html > > > It should probably be listed/visible from : > > > http://incubator.apache.org/tuscany/sdo-java-documentation-menu.htmlas > > > it's > > > one of the pages with more contents on it. > > > looks like is fixed. > > > > > > great > > > > And with 7) we can fix comment #2 - User guide has wrong styles : > > > http://incubator.apache.org/tuscany/sdo-java-user-guide.html > > > > > > fine > > > > Thanks Amita for this useful review. I'll pick some of these things up. > > Can you let me know which you plan to do and which you would like me to > > do? > > Anyone else watching this thread is of course more than welcome to pitch > > in > > too. > > > > Kelvin. > > > > Regards, > > > Amita > > > > > >
