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.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.
When I manually added below line to the https://svn.apache.org/repos/asf/incubator/tuscany/java/sdo/distribution/src/main/release/bin/samples/sampleProgramContents.html it worked fine on firefox. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " http://www.w3.org/TR/html4/loose.dtd";> So I guess I can open a JIRA and fix variable HTML_HEADER from sample-sdo/DocumentSamples to contain the above and it will do the trick. Does this sound OK? > > > 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 > > >
