initial API fleshed out
minor doc fix
changes from last friday
retrofit with right_api_provision gem