Added some notes about a few gotchas.
time to take a break