Add documentation for rspec support

Updates readme to cover rspec matchers and helpers. It also normalized to ExampleExperiment and experiment(:example to be more consistent with itself.