[hibernate-dev] Hibernate ORM and Java 8 usage

[Steve Ebersole]

I agree completely with this.

And yes he did, but then we are moving to Asciidoc :)



On Wed, Jan 13, 2016 at 10:32 AM Hardy Ferentschik <hardy at hibernate.org>
wrote:

> Hi,
>
> > slightly related and just in case you are not aware of this feature
> > yet: You can include (parts of) actual source code files straight into
> > AsciiDoc documents. We do that in the HV reference guide, e.g. at [1].
> > That way you are 100% sure your examples actually compile (and pass
> > tests) and you don't need to copy & paste them.
>
> Damn you beat me to it, I just wanted to write the same thing :-)
> To me, this is the best approach. By using actual test which run as part of
> the documentation build you know that your examples really work and via
> the include syntax you can include the bits and pieces you need into the
> docs.
> Obviously more effort, but I think worth it. IMO examples in the docs
> should be
> as much as possible sourced from actual running tests.
>
> BTW, this is pretty much what Christian always wanted as part of
> this docbook tooling. Not sure whether he ever completed his tool to
> achieve this.
>
> --Hardy
>
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev