making docs more accurate