[Xmlunit-general] Builder Package and some Naming Doubts

[Stefan B. <bo...@ap...>]

Hi all

currently we've got a builder package that bundles classes by their
technical role (they are fluent builders) rather than the API they
belong to.  I've started to wonder whether the concrete builders should
better live in the respective API packages (under different names,
likely).

Also I've realized I'm having a hard time to name things around the diff
package.  The single step the DifferenceEngine performs is a Comparison,
but what is the sum of all those Comparisons?  You can see the problem
in the name of the ComparisonController's stopDiffing method - so is
"diffing" what the DifferenceEngne does?  And is Diff really the best
name for the overall result?

I've always been notoriously bad at naming, maybe anybody else has a
better approach?

Stefan