more doc and future API
docs
share some global config state
pylint