proxy: add docstrings

Thought I did this ages ago but found this branch hanging around