Fix YARD docs to have examples and accurate types