rewrote documentation for greater flow, separated tips from helloworld