made docs more clear