This section is an example:
The Maven coordinates are fine. It's the second half which concerns me.
It ends with an horribly vague "[..] you might need some of the jars
I probably wrote that myself years ago ;-)
I just don't agree with the usefulness of the section anymore, and
considering the intimidating size of overall documentation I'd like to
trim such things.
On 29 March 2017 at 13:17, Davide D'Alto <davide(a)hibernate.org> wrote:
I'm not against it but could you give an example?
I think it would help to clarify what you are talking about.
On Wed, Mar 29, 2017 at 12:39 PM, Sanne Grinovero <sanne(a)hibernate.org> wrote:
> 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.
> hibernate-dev mailing list
hibernate-dev mailing list