[jbossseam-issues] [JBoss JIRA] Commented: (JBSEAM-2506) Remove standalone EM/EMF test example from documentation

[Christian Bauer (JIRA)]

    [ http://jira.jboss.com/jira/browse/JBSEAM-2506?page=comments#action_12395695 ] 
            
Christian Bauer commented on JBSEAM-2506:
-----------------------------------------

Looks good.

> Remove standalone EM/EMF test example from documentation
> --------------------------------------------------------
>
>                 Key: JBSEAM-2506
>                 URL: http://jira.jboss.com/jira/browse/JBSEAM-2506
>             Project: JBoss Seam
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions: 2.0.1.CR1
>            Reporter: Christian Bauer
>         Assigned To: Pete Muir
>            Priority: Blocker
>             Fix For: 2.0.1.GA
>
>
> http://docs.jboss.com/seam/2.0.0.GA/reference/en/html/testing.html
> This first example is extremely confusing for new users, they won't be able to setup EMF/EM for a standalone test. Naturally they will not read on but simply copy/paste the example and try it. Then they run into problems because they don't understand what "This requires configuration in persistence.xml" means.
> I recommend rewriting the whole example and NOT USING the EntityManager in it. Just instantiate a Seam component and call a method on it. Then say: "If you need system services, better do an integration test with Seam Test, no extra configuration necessary."

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira