*if* we keep the javadoc, I would like to only keep the latest
version.... I don't see much point on keeping 24+ versions of the
javadocs

On Wed, Sep 28, 2022 at 2:12 PM Étienne Hossack <activ...@hossack.me> wrote:
>
> -1
>
> Reasons to keep:
> * It's useful to be able to link a specific line/method in the javadoc when 
> explaining something to someone through the use of a URL
> * It's nice to be able to navigate the source code in your browser, if say 
> your IDE is having issues and you can't correctly navigate to docs via sources
> * Often times you can read the ActiveMQ Artemis docs and think you understand 
> a concept, but figuring out how to actually write the code to do it is pretty 
> different - especially when the docs go out of date.
>
> In fact I'd rather the docs continue to reference the source code even more.
>
> If it's a lot of effort to maintain the publishing, I would reconsider for 
> sure my stance, but as it stands, think it's pretty useful, and when my org 
> isn't rate-limited on the apache website, I use them :'-)
>
> --
> Étienne
>
> On Wed, 28 Sep 2022, at 9:12 AM, Clebert Suconic wrote:
> > Can we stop publishing javadocs on the ActiveMQ Website for artemis?
> >
> > I see no point on publishing it as they are available in Maven.
> >
> > My vote is to completely remove it.
> >
> >
> > So, if you agree with me, please respond with
> >
> > +1 Yes, stop publishing javadocs for ActiveMQ Artemis on the website
> > and keep them on maven as usual.
> >
> >
> >
> > if you have any other preferences please state a -1 and a reason for..
> >
> >
> >
> > --
> > Clebert Suconic



-- 
Clebert Suconic

Reply via email to