added some yard markup for new methods