Rest doc updates

Additional docs for #432 
Yeah I was thinking about that too. Maybe it's worth merging this as is and then refactoring all three at the same time. At least adding this shows the option is there.