Many README improvements

Lessons learned while I was setting up bud. Let me know if I made any mistakes or adding something you'd rather not have in the readme.
could you please put it inline here? With `<<EOF`...