Make variant methods documentation friendly

- change the comments to the right style
- tie the request/response objects together like we did for readsets