Fix formatting for feature description.

RelishApp and Cucumber are very picky about syntax. **ANY** line which
starts with an octothorpe is treated as a comment. This makes the lexer
very unhappy.

In order to trick it I had to add a unicode space (specifically the zero
width space <200b>). This alone didn't fix things. For some reason,
using a semi-colon fixed things. I tried several additional variations,
all of which worked; but they each still required the semi-colon:

- `controller { ; }`
- `controller do; end`

I settled on this various as I felt it read a bit better with the
comment being in the `controller` definition.
Merge pull request #1040 from rspec/controller-doc-fixes

Fix formatting for feature description.
Include RSpec 3 changes for inferred metadata.

- Explain the move away from inferred metadata types
- State that default configurations will add the new setting to include
  inferred metadata by default due to all of the online tutorials
- List common Rails metadata `:type` values
- Add tip about mirroring `app/` and `lib/` filesystem structure in
  `spec/`
Doc coverage.

* Many things are private.
* Added docs tend to be terrible, I don't have enough context to flesh
  them out.
* Still some warnings in here I don't know what to do about.
* What do we do about CI? Can rspec-dev add it for us?
Documentation for configuration.
Unbreak MailerExampleGroup loading.
Better documentation for #with
Backticks
Documentation for routes=

@cupakromer not really sure if this is what you were asking for in
https://github.com/rspec/rspec-rails/pull/1034#discussion_r12906450
Better wording for RSpec::Rails::ViewAssigns.
Check doc coverage in travis build.

This is similar but different (see the --exclude) to the function
provided in rspec-dev, so not providing a way to sync them. It's a
simple enough function anyways.
Merge pull request #1041 from rspec/fix-directory-structure-doc

Include RSpec 3 changes for inferred metadata.
Need to include documentation in travis bundle for YARD checks.
Fix broken .yardopts file
Merge pull request #1034 from rspec/doc-coverage

Doc coverage
Replace mocking in generated controller specs with integration tests.
This was a terrible example and should never have been here. This
replacement isn't great, but at least is not obviously bad.

Unfortunately we cannot provide default implementations of these because
we don't have sufficient information about the data model. Specs that
require this are marked pending.

I gave up on the default approach: it doesn't work at all for models
with no attributes, and is a crapshoot if they do.
Merge pull request #1046 from rspec/issue-1008

Replace mocking in generated controller specs with integration tests.
Update README.md

Set the correct name and link for have_http_status matcher, it was still referencing the "old" name have_status.
Merge pull request #1047 from universal/patch-1

Update README.md
Move spec_helper to rails_helper.

The first step to providing the ability to only include the necessary
parts of Rails to keep specs happy. By separating general RSpec
configuration from the Rails specific configuration, any specs which
don't need rails, can load a standard helper.

- Update Rails generators to reference the new helper file
- Fix specs for the generators
- Let cukes know about `rails_helper`