more logs & some doc updates