[#37] document validatoins, references