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.
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. -- John > On 5 Jul 2014, at 04:46, Maruan Sahyoun <sahy...@fileaffairs.de> wrote: > > Hi, > > I have the infrastructure for enhancing our documentation nearly sorted > (needed to learn a little more about the possibilities of the Apache CMS). > Now WDYT would be the expectation for documenting how to use PDFBox for > different use cases - code snippets or runnable examples? > > BR > Maruan
