editing docs to be more clear and simple