Thank you, really good suggestion. We'll see if we can put snippets on the main page to help with this.
One of the biggest draws for this sort of thing from the dev side is "how far am I going to have to bend over to use this".
Freely available documentation sounds like a no-brainer.
Here is the docs: https://airship.readme.io/v1.0/docs. We'll also link them in our home page in the next iteration.