@ssmusoke, I do think that module provides a reasonable set of best practices, as they currently exist. It demonstrates how to add custom definitions, how to add your own libraries, how to set up reports automatically.
Longer term, I personally would like to see us shift our focus to enabling more to be defined outside of java code, and in more configuration files. We have taken some tentative steps in this direction but it is by no means complete.
Nothing that exists in the legacy UI can really be considered the way into the future. What aspects are you referring to specifically?