further clarified docs