Add yard-doctest and wire it to spec runs

This ensures all our @example code actually works - yard-doctest takes
those tags and converts them into tests that it then runs.