doc strings, return this rather than magic nil
apply config