Rest doc updates

Additional docs for #432 
I think this change is in another pull request?