added documentation on create, update, ship and autodetect role
incorporated pr comments
Merge pull request #51 from feelobot/better-documentation

added documentation on create, update, ship and autodetect role