Improved documentation for several types.
Reduced the visibility of some property setters which were confusingly exposed to derrived types.
Provided usage guidelines for custom comparer class.