Add more comments for yard and bit of the readme, ready for 0.0.3 launch.