Documentation and common error traps

Improved communication for two common issues people have when building:

1. Needing to run api_gen.py
2. Build failures with "cannot import name _errors"

Prompted by #341 and many previous issues on the list.