public query functions and documentation