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.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 >