improved documentation

custom queries