readme and internal queries methods