Fix examples in the code documentation

YARD requires the code examples to be indented.
Some doc corrections

Improve how the documentation of these classes look in YARD.
Fix Travis CI

Fix the long line offence.