added discriminator docs
Merge pull request #1801 from j/docs

Added discriminator docs