Documentation

A bit of documentation clean-up, fixing a couple of YARD syntax issues and aiming to increase coverage of the core classes/modules.