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.