Hi Roger,

Thank you for your encouraging feedback and your input.

> 1) http://www.jooq.org/tutorial.php#step3
>
>        The example code includes
>
>           import static test.generated.Tables.*
>
>        This seems to be wrong with 2.6 as the import point is the package
> rather than a class with static entries.

There should indeed be a generated Tables class within the
test.generated package, so the import should be correct. I have to
admit, though, that I have never actually executed this tutorial, as
it was contributed in a similar form by Ikai Lan:
http://ikaisays.com/2011/11/01/getting-started-with-jooq-a-tutorial/

Maybe I should review it for integrity... I have registered #1997 for this:
https://github.com/jOOQ/jOOQ/issues/1997

> 2) http://www.jooq.org/doc/2.6/manual/code-generation/codegen-configuration/
>
>       The image showing the Referenced Libraries needed to set up Eclipse is
> out of date as the jars are now version stamped and jooq-meta-2.6.0.jar
> needs to be included

I think I will refrain from updating the pictures with the version
stamp at every release :-)
But good hint about jooq-meta. It should clearly be included in the
image. I have registered #1998 for this:
https://github.com/jOOQ/jOOQ/issues/1998

> Both of the above slowed me down when first trying to eval jOOQ as I needed
> to extend my understanding of the product before I could follow the basic
> examples.

Thanks again for your valuable feedback. It is always good to hear a
new user's opinion on the documentation, as new users haven't gotten
used to flaws yet. Any further issues you may discover are welcome on
this list!

> Also with the speed at which jOOQ is evolving can I suggest that the whole
> community starts to add a comment in any example code that they post to
> indicate which release of jOOQ the example is for. There are many well
> thought out examples posted on blogs across the internet, but many will not
> work with the current release and so again slow the process of doing an
> eval.

This will be more tricky. I can control examples on my own blog
(http://blog.jooq.org) and on Stack Overflow. Do you have any specific
examples in mind?

Cheers
Lukas

Reply via email to