[hibernate-dev] Tutorial Examples

[Steve Ebersole]

Just to be clear...  This point is a detail.  More I am interested in
opinions of the user experience here; specifically the documentation
discussing code which is open another window/app.

If we move forward with this in theory, then we will need to decide this
and other details.

On Mon, 2010-08-30 at 09:22 -0500, Steve Ebersole wrote:
> The zip will not be under source control.  Its contents will, however
> the zip itself will not.  Not an issue with jDocBook, but as-is that
> wont work with publican.
> 
> On Sun, 2010-08-29 at 18:48 -0400, Misty Stanley-Jones wrote:
> > Another possibility is including the .zip in the document bundle (for non-PDF document targets, at least). Publican can handle this by putting the .zip in a files/ subdirectory and using a <ulink> to its relative location. This is one way to have a 1:1 relationship between the doc version and the .zip version.
> > 
> > ----- hibernate-dev-request at lists.jboss.org wrote:
> > 
> > > From: hibernate-dev-request at lists.jboss.org
> > > To: hibernate-dev at lists.jboss.org
> > > Sent: Saturday, August 28, 2010 2:00:05 AM GMT +10:00 Brisbane
> > > Subject: hibernate-dev Digest, Vol 50, Issue 13
> > >
> > > Send hibernate-dev mailing list submissions to
> > > 	hibernate-dev at lists.jboss.org
> > > 
> > > To subscribe or unsubscribe via the World Wide Web, visit
> > > 	https://lists.jboss.org/mailman/listinfo/hibernate-dev
> > > or, via email, send a message with subject or body 'help' to
> > > 	hibernate-dev-request at lists.jboss.org
> > > 
> > > You can reach the person managing the list at
> > > 	hibernate-dev-owner at lists.jboss.org
> > > 
> > > When replying, please edit your Subject line so it is more specific
> > > than "Re: Contents of hibernate-dev digest..."
> > > 
> > > 
> > > Today's Topics:
> > > 
> > >    1. Tutorials (Steve Ebersole)
> > >    2. Re: Tutorials (Emmanuel Bernard)
> > >    3. Re: Tutorials (Steve Ebersole)
> > >    4. Re: Tutorials (Hardy Ferentschik)
> > >    5. Re: Tutorials (Steve Ebersole)
> > >    6. Re: Tutorials (Steve Ebersole)
> > > 
> > > 
> > > ----------------------------------------------------------------------
> > > 
> > > Message: 1
> > > Date: Thu, 26 Aug 2010 13:21:12 -0500
> > > From: Steve Ebersole <steve at hibernate.org>
> > > Subject: [hibernate-dev] Tutorials
> > > To: hibernate-dev at lists.jboss.org
> > > Message-ID: <1282846872.12095.12.camel at apollo>
> > > Content-Type: text/plain; charset="UTF-8"
> > > 
> > > http://opensource.atlassian.com/projects/hibernate/browse/HHH-5441
> > > 
> > > There was a suggestion to externalize all the tutorial source into a
> > > separate zip to make it even easier to get started.  So as a user I'd
> > > be
> > > able to download the tutorials.zip (with or without the "getting
> > > started
> > > guide"), extract it and be up and running.  The actual documentation
> > > would then not have to have the contents of all these files in total,
> > > which help cut down on the size as well, though might make it not as
> > > easy to follow, not sure.
> > > 
> > > Curious what y'all thought about this based on other tutorial sets
> > > you
> > > have run across and used.
> > > 
> > > -- 
> > > Steve Ebersole <steve at hibernate.org>
> > > http://hibernate.org
> > > 
> > > 
> > > 
> > 
> 

-- 
Steve Ebersole <steve at hibernate.org>
http://hibernate.org