added some docs detail