[hibernate-issues] [Hibernate-JIRA] Issue Comment Edited: (HHH-5442) Write native tutorial chapter

[Steve Ebersole (JIRA)]

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

Steve Ebersole edited comment on HHH-5442 at 8/24/10 10:15 AM:
---------------------------------------------------------------

Misty (jira comment!),

Consider a fragment as follows:
{code:xml}
<warning>
    <para>
        The built-in Hibernate connection pool is in no way intended for production use. It
        lacks several features found on any decent connection pool.  See the section "JDBC Connections" in
        the "Database Access" chapter of the "Hibernate Developer Guide" for further information.
    </para>
</warning>
{code}
What is the "proper way" to mark up and/or phrase that reference to another guide?

      was (Author: steve):
    Misty (jira comment!),

Consider a fragment as follows:
{code}
<warning>
    <para>
        The built-in Hibernate connection pool is in no way intended for production use. It
        lacks several features found on any decent connection pool.  See the section "JDBC Connections" in
        the "Database Access" chapter of the "Hibernate Developer Guide" for further information.
    </para>
</warning>
{code}
What is the "proper way" to mark up and/or phrase that reference to another guide?
  
> Write native tutorial chapter
> -----------------------------
>
>                 Key: HHH-5442
>                 URL: http://opensource.atlassian.com/projects/hibernate/browse/HHH-5442
>             Project: Hibernate Core
>          Issue Type: Sub-task
>          Components: documentation
>            Reporter: Steve Ebersole
>            Assignee: Steve Ebersole
>             Fix For: 3.6.0.Beta4
>
>          Time Spent: 16.75h
>  Remaining Estimate: 0h
>
> This is largely a task to extract the existing tutorial from the existing "reference manual".

-- 
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