change settings and improve docs