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-requ...@lists.jboss.org wrote: > > > > > From: hibernate-dev-requ...@lists.jboss.org > > > To: hibernate-dev@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@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-requ...@lists.jboss.org > > > > > > You can reach the person managing the list at > > > hibernate-dev-ow...@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 <st...@hibernate.org> > > > Subject: [hibernate-dev] Tutorials > > > To: hibernate-dev@lists.jboss.org > > > Message-ID: <1282846872.12095.12.ca...@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 <st...@hibernate.org> > > > http://hibernate.org > > > > > > > > > > > > -- Steve Ebersole <st...@hibernate.org> http://hibernate.org _______________________________________________ hibernate-dev mailing list hibernate-dev@lists.jboss.org https://lists.jboss.org/mailman/listinfo/hibernate-dev