Re: [Java SDO] Tuscany SDO Java 1.1-incubating
In the interest of avoiding the confusion that can be caused by cross-list posting, we'lll continue this discussion over on the user list here at http://www.mail-archive.com/[EMAIL PROTECTED]/msg02415.html, please make sure you are subscribed to this list if you wish to be involved Regards, Amita On Jan 18, 2008 4:08 PM, 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/tuscany-dev@ws.apache.org/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 pa
Re: [Java SDO] Tuscany SDO Java 1.1-incubating
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/tuscany-dev@ws.apache.org/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.html no > 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.html and > 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.html as > 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 >
[Java SDO] Tuscany SDO Java 1.1-incubating
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/tuscany-dev@ws.apache.org/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.html we have - Open CSA (SCA Standards) 2) changes in http://incubator.apache.org/tuscany/tuscany-sdo-java-faq.htmlfor new features, improvements 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 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? 3) http://incubator.apache.org/tuscany/tuscany-sdo-java-faq.html page does not have menu 4) http://incubator.apache.org/tuscany/sdo-project-code-structure.html no menu , old structure 5) http://incubator.apache.org/tuscany/getting-source.html no menu and old structure 6) developer guide - should we refer to http://incubator.apache.org/tuscany/sca-java-development-guide.html and make SDO Dev Guide more complete? 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.) Can we provide this link in http://incubator.apache.org/tuscany/sdo-java-user-guide.html 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.html as it's one of the pages with more contents on it. looks like is fixed. And with 7) we can fix comment #2 - User guide has wrong styles : http://incubator.apache.org/tuscany/sdo-java-user-guide.html Regards, Amita