[hibernate-issues] [Hibernate-JIRA] Commented: (HHH-5441) Create "Getting Started Guide"

[Steve Ebersole (JIRA)]

    [ http://opensource.atlassian.com/projects/hibernate/browse/HHH-5441?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=38088#action_38088 ] 

Steve Ebersole commented on HHH-5441:
-------------------------------------

# WRT avoiding <xi:include ... parse="text" />, jDocBook is not handling parse="text" xincludes properly in that we inject extra entity definitions.  The problem is that we do not know the parse type (we literally do not have access to it from the XML parser).  We can chat about this on IRC if you want.  I agree btw that this is how it should be done *ideally*.  We never did it this way because we never knew about it.
# For sure linking back to the tutorial upon which a subsequent tutorial builds is fine.  Problem is though that these are not sequential.  After the first one (native) they should go on to the second (annotations), but from there they might move on to either 3 (jpa/entitymanager) or 4 (envers)

> Create "Getting Started Guide"
> ------------------------------
>
>                 Key: HHH-5441
>                 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5441
>             Project: Hibernate Core
>          Issue Type: Improvement
>          Components: documentation
>            Reporter: Steve Ebersole
>            Assignee: Steve Ebersole
>             Fix For: 3.6.0.Beta3
>
>          Time Spent: 13m
>  Remaining Estimate: 0h
>
> High-level TOC
> - Preface (eventually (?DITA?) share this between the Getting Started Guide and the Developer Guide)
> - Engaging the Hibernate community
> - Obtaining Hiberate
> -- SourceForge release bundles
> -- Maven repository
> --- Discussion of artifacts and relationships between them
> - Native API tutorial
> - Annotations tutorial
> - EntityManager/JPA tutorial
> - Envers tutorial

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