added some yard docs