Fix typos in ChefSpec::Deprecations

I found a missing space between sentences in the deprecation message raised by ChefSpec::Runner.define_runner_method. So I put it in and rearranged spaces to follow the style of other broken-up messages in that file.

Then I noticed that the yardoc `@deprecated` note was also referring to the wrong methods (old and new). So I edited those as well.