Have separate about_Classes and about_DSC_Classes
The aboutClasses help file should not have any DSC class information except for a "See Also" reference to a separate aboutDSC_Classes, which will of course have lots of details for DSC.
This will help combat the perception that PowerShell classes are not "real" classes for serious programmers, and that PowerShell classes were not added just for the sake of supporting DSC.
The about_Classes file should be further fleshed out so that C#, Java and Python developers will know what to (not) expect when using PowerShell classes.
https://github.com/PowerShell/PowerShell-Docs/pull/1195 resolves this issue. It will flow into console get-help with the resolution of this issue: https://github.com/PowerShell/PowerShell-Docs/issues/1073