extra documentation and extra example files
improved query generation