Mind moving these comments into method documentation so that Yard will pick them up?