add miredot annotations for api docs