updated docs / logging