doc updates to SmartApp developer's guide

@bflorian 

Includes changes from Bob's PR here: https://github.com/SmartThingsCommunity/Documentation/pull/28

Plus a few updates of my own.