adding configuration object, improved docs