Digressing a bit here about this point.. In the long-term I think that it would be a good idea to have a template module in src/test/modules/ that shows how to use a CustomScan so as it is able to demonstrate how this stuff works, and to check if it is works as intended. With regression tests, of course.