Doc updates

I hit a few gotchas so called them out so others do not