[seam-issues] [JBoss JIRA] (SEAMPERSIST-70) Seam Persistence documentation issues and comments

[Marek Schmidt (Created) (JIRA)]

Seam Persistence documentation issues and comments
--------------------------------------------------

                 Key: SEAMPERSIST-70
                 URL: https://issues.jboss.org/browse/SEAMPERSIST-70
             Project: Seam Persistence
          Issue Type: Bug
    Affects Versions: 3.1.0.Beta3
            Reporter: Marek Schmidt
             Fix For: 3.1.0.Final


    Persistence

        In general
            * lots of persistence docs mention seam transactional stuff, while the Seam transactional docs are empty. The documentation should perhaps explain the persistence/transactional split and what modules does what.

        1.2. Getting Started

            * "seam-solder.jar" should be "solder-impl.jar",
            * "If you are in a java SE environment you will probably also require seam-xml.jar as well for configuration purposes."
                should be removed
           

            *  "seam-persistence-impl" should be "seam-persistence"
            * "org.jboss.seam.solder" should be "org.jboss.solder"
            * "seam-solder" should be "solder-impl"
            * "org.jboss.seam.xml:seam-xml-config" dependency should be removed

        1.3. Transaction Management
            * "Seam" should perhaps be "Seam Persistence"?
        
        1.3.1. Configuration 
            * "seam-xml" should be "Solder XML"
            * "Seam Config XML" should be "Solder Config XML"

            * typo in the example fragment "</tentityManager>" instead of "</t:entityManager>"
            * "If you need multiple persistence units in your application then we highly recommend using an EE 6 compatible server, such as JBoss 6."
                we should probably suggest JBoss AS 7 instead.

        Missing pieces
            * FlushModeManager, FlushModeType, ManagedPersistenceContext, PersistenceContexts, are not documented


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.jboss.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira