[jboss-dev-forums] [Design of EJB 3.0] - Re: EJBTHREE-1607 Update EJB3.0 Tutorials

[jaikiran]

What remains on the tutorial part:

1) The "jca_inflow_quartz" tutorial which is being tracked here http://www.jboss.com/index.html?module=bb&op=viewtopic&t=148386 and will be fixed today

2) The "tableperinheritance" tutorial which is broken because of a issue in HSQLDB.
https://jira.jboss.org/jira/browse/EJBTHREE-1657

http://opensource.atlassian.com/projects/hibernate/browse/HHH-2920

I am planning to include this tutorial and add a note to the guide saying its broken on HSQLDB. If someone wants to try to use the tutorial against a different DB, then they could do so. We could have upgraded the tutorial to use some other DB like MySQL, but that would involve listing the steps required to download/install/start the MySQL server. Any opinion?

3) The "thirdpartyjms" tutorial - This one involves downloading/installing/starting a thirdparty JMS server (like OpenJMS). Should we be including this in our tutorials? If yes, then we would have to see how we can integrate this steps in our Mavenized tutorial.

4) The "HTTP_HTTPS" tutorial - This one shows how an EJB can be accessed via HTTP/HTTPS. Involves multiple configuration changes to the JBossAS. If we have to include this tutorial through our Maven process, then will have to think of a way where we can configure the server configuration of JBossAS and restart it with these changes. Any opinions?

For #3 and #4, i guess we also have "reference guide" for EJB3, where the documentation to configure the AS to achieve these functionality can be documented. 

What remains on the tutorial guide part:

1) The documentation for most these completed tutorials has already been committed. 

2) The Maven plugin which generates this docbook style documentation allows uploading the guide in a "war" format to Maven repositories. A snapshot version of the guide is available at http://snapshots.jboss.org/maven2/org/jboss/ejb3/tutorial/documentation/jboss-ejb3-tutorial-user-guide-en-US/1.0.0-SNAPSHOT/

3) However i was thinking more on the following lines for making available the tutorial and the guide:
	* A downloadable version of the tutorial (source code) and the guide - We can make this available on our EJB3 project site download page. This will help the users to run these tutorials offline.
	* A (latest/live) version of the tutorial and the guide - The live version of the tutorial can be checked out from SVN. However, for providing a live version of the guide (in html format rather than the war format), i am still looking to see if there are some options available. Anyone has any suggestions?


View the original post : http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4202787#4202787

Reply to the post : http://www.jboss.com/index.html?module=bb&op=posting&mode=reply&p=4202787