add yard doc comments