As demonstrated by the CollectionClassifier example, overloading can easily confound these expectations.
I've found overloading to often lead to:
1. Questions about the omission of params (what's the behavior of the fewer-parameter variant; i.e., what's the behavior of the other params?)
2. Jumping between the various overloads' javadocs, resolving the differences, and
3. Resorting to inspecting source to see what the difference is.
When overloading is necessary, there's usually a much greater burden of clear and comprehensive documentation.
· Flag
Brian
