[hibernate-dev] Getting rid of our specific JavaDoc CSS?

Steve Ebersole steve at hibernate.org
Thu Nov 30 13:41:48 EST 2017


Now that I've looked more, I agree.  That standard one is much closer to
the feel of the new website/blogs

On Thu, Nov 30, 2017 at 12:35 PM Davide D'Alto <daltodavide at gmail.com>
wrote:

> Sounds good to me.
>
>
> On Thu, Nov 30, 2017 at 3:11 PM, Guillaume Smet
> <guillaume.smet at gmail.com> wrote:
> > Hi,
> >
> > So, apparently, our JavaDoc CSS is a bit outdated as we now have a "Skip
> > navigation links" link at the top of our doc that should be hidden by
> > default.
> >
> > Frankly, I see very little value in maintaining our own JavaDoc CSS. It
> > requires work (see above and the future JDK 9 upgrade - Marko did a first
> > pass on Validator but it required some time).
> >
> > Moreover, I find the new default CSS much more readable and attractive
> than
> > ours.
> >
> > Compare:
> > https://docs.jboss.org/hibernate/stable/search/api/
> > with:
> > http://docs.jboss.org/jberet/1.3.0.Beta2/javadoc/jberet-core/
> >
> > I would say a JavaDoc is a JavaDoc and I would prefer if our users just
> got
> > the standard layout they are used to on other projects.
> >
> > Bonus point: when we include external projects javadoc in ours, we end up
> > having both layouts mixed, which is not very nice.
> >
> > And if it saves us some work, it's all good, isn't it?
> >
> > Thoughts?
> >
> > --
> > Guillaume
> > _______________________________________________
> > hibernate-dev mailing list
> > hibernate-dev at lists.jboss.org
> > https://lists.jboss.org/mailman/listinfo/hibernate-dev
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev
>


More information about the hibernate-dev mailing list