[bugfix,documentation] Fix doxygen grouping of public methods
[bugfix,documentation] Minor documentation improvements
[documentation] Move method hasBoundaryIntersections out of the 'Interface for the Implementor' section

I suppose the previous location was a bug.  Why should this method be only for
(grid) implementors?