Hi,
As we get the M2 branch fairly stable in the sense of code, now it's time to
look at the documents and web site.
I'm seeing several issues here:
1) Documents are scatted in different sources, including Web site, SVN, and
Wiki. We don't have an organized navigation to these information.
2) Some of the documents are out of date and some of them are not complete.
3) We don't document for some features such as async web services.
To jump start the efforts, I list some documents I expect to be useful for
the release. I also collect a list of existing materials under each item.
It's available @ http://wiki.apache.org/ws/Tuscany/TuscanyJava/M2Release.
General stuff:
1) How to download the release?
2) How to check out the source from SVN and build with Maven?
3) How to load the source into IDEs such as Eclipse or IDEA and how to
debug?
4) How to work with Tomcat?
http://wiki.apache.org/ws/Tuscany/TuscanyJava/SCA_Java
http://wiki.apache.org/ws/Tuscany/TuscanyJava/GetTuscany
For end-users:
1) A document discribing how to develop/build/run standalone applications.
I found there are already readmes for the samples and we could make them a
bit generic so that they can be published to the web site.
http://svn.apache.org/repos/asf/incubator/tuscany/branches/sca-java-M2/samples/standalone/calculator/README.txt
http://svn.apache.org/repos/asf/incubator/tuscany/branches/sca-java-M2/samples/standalone/calculator-combo/Calculator-Combo-Readme.htm
2) A document discribing how to develop/build/run web applications.
http://svn.apache.org/repos/asf/incubator/tuscany/branches/sca-java-M2/samples/webapp/calculatorws/Calculator-Web-Service-Readme.htm
http://wiki.apache.org/ws/Tuscany/TuscanyJava/WebApp
http://svn.apache.org/repos/asf/incubator/tuscany/branches/sca-java-M2/samples/applications/bigbank/readme.htm
For extension developers:
3) Architecture overview
http://svn.apache.org/repos/asf/incubator/tuscany/branches/sca-java-M2/sca/doc/
4) How to extend tuscany?
http://svn.apache.org/repos/asf/incubator/tuscany/branches/sca-java-M2/sca/doc/extending.tuscany.ppt
http://wiki.apache.org/ws/Tuscany/TuscanyJava/Extending
5) DataBinding
http://wiki.apache.org/ws/Tuscany/TuscanyJava/SCA_Java/DataMediation
Please add yours and help with the documents which are critical to the
success of our M2.
Thanks,
Raymond
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
