Rest doc updates

Additional docs for #432 
Whoops!  Good catch.  Will fix this.