doc changes + comments