make docs more clear