5:48 p.m.
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(a)lists.jboss.org wrote:
From: hibernate-dev-request(a)lists.jboss.org
To: hibernate-dev(a)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(a)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(a)lists.jboss.org
You can reach the person managing the list at
hibernate-dev-owner(a)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(a)hibernate.org>
Subject: [hibernate-dev] Tutorials
To: hibernate-dev(a)lists.jboss.org
Message-ID: <1282846872.12095.12.camel@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(a)hibernate.org>
http://hibernate.org
--
Misty Stanley-Jones
Content Author, ECS Brisbane
Ph: +61 7 3514 8105
RHCT #60501081553354
Purgamentum init, exit purgamentum.
9:22 a.m.
New subject: Tutorial Examples
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(a)lists.jboss.org wrote:
> From: hibernate-dev-request(a)lists.jboss.org
> To: hibernate-dev(a)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(a)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(a)lists.jboss.org
>
> You can reach the person managing the list at
> hibernate-dev-owner(a)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(a)hibernate.org>
> Subject: [hibernate-dev] Tutorials
> To: hibernate-dev(a)lists.jboss.org
> Message-ID: <1282846872.12095.12.camel@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(a)hibernate.org>
> http://hibernate.org
>
>
>
--
Steve Ebersole <steve(a)hibernate.org>
http://hibernate.org
9:54 a.m.
New subject: Tutorial Examples
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(a)lists.jboss.org wrote:
>
> > From: hibernate-dev-request(a)lists.jboss.org
> > To: hibernate-dev(a)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(a)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(a)lists.jboss.org
> >
> > You can reach the person managing the list at
> > hibernate-dev-owner(a)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(a)hibernate.org>
> > Subject: [hibernate-dev] Tutorials
> > To: hibernate-dev(a)lists.jboss.org
> > Message-ID: <1282846872.12095.12.camel@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(a)hibernate.org>
> > http://hibernate.org
> >
> >
> >
>
--
Steve Ebersole <steve(a)hibernate.org>
http://hibernate.org
5002
days inactive
5003
days old
2 comments
2 participants
participants (2)
-
Misty Stanley-Jones -
Steve Ebersole