Added more documentation

Hi there,

I added some documentation to `aruba/api.rb`. Furthermore I moved the contribution guidelines to a separate file because github.com displays this file on PR. Might avoid some mistakes in PRs. :-)

Cheers,
dg