0001048: Website EJB3 documentation inconsistent & mail lists not searchable

Viewing Issue Advanced Details [ Jump to Notes ]

[ View Simple ] [ Issue History ] [ Print ]

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

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[^]

29 total queries executed.
26 unique queries executed.