adding some docs that did not make it last commit