Mantis Bugtracker
  

Viewing Issue Advanced Details Jump to Notes ] View Simple ] Issue History ] Print ]
ID Category Severity Reproducibility Date Submitted Last Update
0001048 [Resin] text always 04-12-06 04:48 04-14-06 10:16
Reporter keith View Status public  
Assigned To ferg
Priority normal Resolution fixed Platform
Status closed   OS
Projection none   OS Version
ETA none Fixed in Version 3.0.19 Product Version
  Product Build
Summary 0001048: Website EJB3 documentation inconsistent & mail lists not searchable
Description Please take this as constructive criticism, it should really help fellow resin newbies!

I found the EJB3.0 documentation a bit lacking, especially with regard to entity beans

This page:
http://www.caucho.com/resin-3.0/ejb3/cmp-table.xtp [^]

Has this section with links to entity bean examples which are broken:

START PAGE EXCERPT
See Also

See Basic tutorial for a complete single-table example.
See Many-to-one tutorial for basic relations.
END PAGE EXCERPT


Also its not really clear which versions of the EJB3 spec resin follow, it seems like it follows all of them :-)

@Inject seems to work but is no longer part of the spec, I found this in a tutorial

@Id(generate=AUTO) VS.
@Id(generate=GeneratorType.AUTO)

@JoinTable VS.
@AssociationTable

Also, something that took me ages to discover is that the 'Amber' link on the left of the documentation page contains way more info on EJB3 than the EJB3 link! and Amber is not mentioned in the EJB3 link! I just stumbled across!


I'm no EJB3 expert but some of the tutorials are making it extra hard due to these inconsistencies, especially if you mix it with non-caucho EJB3 tutorials (such as JBoss - which I'm running away from)

One more tip - the mailing lists hold a wealth of information but are not searchable. The forums are relatively quiet, I suggest closing integrating the mailing into the forums and then making the whole lot searchable.

Other than that I've very happy with resin, I may achieve my utopia of an EJB3 business and persistence layers with a thin PHP presentation layer!



Steps To Reproduce
Additional Information
Attached Files

- Relationships

- Notes
(0001091)
ferg
04-14-06 10:16

3.0.19 is upgrading Amber to the most recent draft specification, so there are a good number of changes. The internal copy of the documentation has been upgraded as has the wiki. The main caucho website will be updated with the 3.0.19 release.
 

- Issue History
Date Modified Username Field Change
04-12-06 04:48 keith New Issue
04-14-06 10:16 ferg Note Added: 0001091
04-14-06 10:16 ferg Assigned To  => ferg
04-14-06 10:16 ferg Status new => closed
04-14-06 10:16 ferg Resolution open => fixed
04-14-06 10:16 ferg Fixed in Version  => 3.0.19


Mantis 1.0.0rc3[^]
Copyright © 2000 - 2005 Mantis Group
29 total queries executed.
26 unique queries executed.
Powered by Mantis Bugtracker