flesh out service querying docs and improve formatting