update documentation with new, simpler response