Rest doc updates

Additional docs for #432 
Good to go