Some doc corrections

Improve how the documentation of these classes look in YARD.