Thomas you are completly right!
IMHO, samples provided by Progress are made by those who introduced the functionality into the product. Soooo, neither are the best practice, nor are they real life examples.
In my opinion, whenever somebody asked me after I had answered a question, "Where exactly can I read about this particular solution in the documentation & samples?" - I answered something like "it's like driving a car, whatever regulations you need to obey, you are still the driver and you must take responsability and make you own decision ..."
Best regards, RealHeavyDude.