Document issue relating to combining the example matcher class pair
consisting of extensible abstract superclass and concrete subclass
into a single class.
Added comments to a couple of the code examples