I'm brushing up some OGM documentation, and noting that we regularly
make examples for both people consuming Maven pom definitions, and
people downloading our distribution and trying to figure out which
jars they need.
I am not aware of specific problems with the instructions we give, but
they all look highly suspicious; instructions are incomplete at best
as we don't go into details.
And we don't test these either.. I'm confident that if I were to test
these instructions most would be out of date.
While I'm aware that some people still don't use dependency management
tools; I'm inclined to remove these documentation sections and abandon
this population to their fate... at least we'd be slimming down the
docs a bit for the sake of most developers.
Any strong objections?
If we really want to keep these, it would be great to have a
documentation section generated from the maven dependencies but I
don't think this is our priority now.