Added another boatload of documentation (YARD style)