Rest doc updates

Additional docs for #432 
OK.  Let me fix that rogue commit before merge.