making docs more clear