[hibernate-dev] Tutorials

[Hardy Ferentschik]

I also like the idea of externalizing the docs.

Have you thought about building maven archetypes? Not sure whether this  
would be possible with gradle though.
Besides the archetype plugin sucks.

Regarding the versions. Wouldn't you you some sort of filtering during  
build time?

--Hardy


On Thu, 26 Aug 2010 21:26:25 +0200, Steve Ebersole <steve at hibernate.org>  
wrote:

> Another worry is "linking" these with versions without hardcoding the
> urls etc.  Especially artifact versions inside the poms in the zip.
>
> On Thu, 2010-08-26 at 21:15 +0200, Emmanuel Bernard wrote:
>> The CaveatEmptor app was doing that. I think it's a good idea.  
>> Christian told be it was quite popular.
>>
>> That being said, I think the getting started guide explaining the  
>> tutorial should keep an embedded copy of the sources (at least partial  
>> - showing the code on the focused feature) to show people how to do  
>> things even if they don't download the sources per se.
>>
>> Emmanuel
>>
>> On 26 août 2010, at 20:21, Steve Ebersole wrote:
>>
>> > 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
>> >
>> > _______________________________________________
>> > hibernate-dev mailing list
>> > hibernate-dev at lists.jboss.org
>> > https://lists.jboss.org/mailman/listinfo/hibernate-dev
>>
>