Am 05.07.2014 18:45, schrieb John Hewson:
I'm for runnable examples in trunk on SVN, otherwise we'll end up with code that doesn't actually run. Some snippets from these examples could be put on the website but they should always link back to the example file in SVN viewvc - there's nothing more frustrating for a new user than incomplete examples, or having to copy and paste snippets together to recreate an example file.
Maybe the best is both. Sadly, I don't remember how I wrote my first pdfbox application - probably both from the pdfbox website and on stackoverflow. But I don't remember any pain.
One thing to improve in the documentation might be to tell that one could just download the app, instead of downloading pdfbox, fontbox and jempbox each time.
Looking at the examples we have currently on SVN the coding conventions used are starting to look a bit dated, certainly far behind more recently written code.
Well, I thought I respect the conventions :-) Tilman