Fix documentation for nested described_class
Created by: pirj
Fixes #2627 (closed)
Documentation for described_class
was out of date, a change was made in early 3.0 in #1361, but was not reflected to the docs.
Also, documentation for implicit subject
was off, even though there is a feature describing how it behaves.