improve config and documentation