Added warts and gotchas section and a few more links