Fixes to documentation:

- typos
- Added bug warning