refine docs
- grab the config from the class itself
- deprecate flags
- merge doc strings with attributes properly