specification interface : add docblock