First of all, great idea :) Ingo Wiarda schrieb: > =head1 SYNOPSIS > ... > path => "download/", > # where to save the job descriptions
I personally find it more easy to understand to place the comments _above_ the code, as the reader then first sees _what_ you're doing and after that _how_ you're doing it. The details should follow the overview and not vice versa IMHO. > Search results are collected and may be filtered and stored > temporarily for offline-use. _May_ be stored or _must_ be stored on disk? As you supply a storage path in the example in the synopsis, it does a bit look like that it has to be done like this. Are there also options to just get everything in a perl data structure without storing it in a directory on disk? This way one could e.g. save it in a database instead of some files on a disk. -Thomas
