first draft of documentation for respa
(cherry picked from commit d7dcbcfbd9c663ad7a1e1ce0989cd6347651fe21)