documentation & some new logs