I plan to update all these code in the PR with the YARD docs so I'll expand on these pieces where appropriate.