You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@kafka.apache.org by sebb <se...@gmail.com> on 2021/03/06 11:33:39 UTC

Why are Javadocs published on downloads.apache.org?

As the subject says: AFAICT the Kafka project is the only project
which publishes Javadocs as individual files on downloads.a.o.

What is the use case for this?
The Javadocs are already published on the Kafka website.

The mirror system relies on volunteers, and not all of them have lots
of disk space, so it is important to minimise what is published.
Additional files also increase the network traffic when synching (this
is a minor consideration, but it's still a waste of resources if the
files are unnecessary.)

Sebb.

Re: Why are Javadocs published on downloads.apache.org?

Posted by "Matthias J. Sax" <mj...@apache.org>.
Done.

On 3/17/21 5:14 AM, sebb wrote:
> On Wed, 17 Mar 2021 at 11:56, Tom Bentley <tb...@redhat.com> wrote:
>>
>> Hi Sebb,
>>
>> I think this has been addressed for future releases by
>> https://github.com/apache/kafka/pull/10203.
> 
> Thanks for the info. I hope that fixes it.
> 
>> AFAIU removing the Javadocs for
>> previous releases would need to be done by someone on the PMC.
> 
> Yes, normally only PMC members can update the source at:
> 
> https://dist.apache.org/repos/dist/release/kafka/
> 
> If any from the PMC is available, please could they invoke:
> 
> svn rm https://dist.apache.org/repos/dist/release/kafka/2.6.1/javadoc/
> and
> svn rm https://dist.apache.org/repos/dist/release/kafka/2.7.0/javadoc/
> 
> Thanks,
> Sebb.
> 
>> Kind regards,
>>
>> Tom
>>
>> On Wed, Mar 17, 2021 at 11:47 AM sebb <se...@gmail.com> wrote:
>>
>>> PING?
>>>
>>> On Sat, 13 Mar 2021 at 15:40, sebb <se...@gmail.com> wrote:
>>>>
>>>> Is anyone there?
>>>>
>>>> On Sat, 6 Mar 2021 at 11:33, sebb <se...@gmail.com> wrote:
>>>>>
>>>>> As the subject says: AFAICT the Kafka project is the only project
>>>>> which publishes Javadocs as individual files on downloads.a.o.
>>>>>
>>>>> What is the use case for this?
>>>>> The Javadocs are already published on the Kafka website.
>>>>>
>>>>> The mirror system relies on volunteers, and not all of them have lots
>>>>> of disk space, so it is important to minimise what is published.
>>>>> Additional files also increase the network traffic when synching (this
>>>>> is a minor consideration, but it's still a waste of resources if the
>>>>> files are unnecessary.)
>>>>>
>>>>> Sebb.
>>>
>>>

Re: Why are Javadocs published on downloads.apache.org?

Posted by sebb <se...@gmail.com>.
On Wed, 17 Mar 2021 at 11:56, Tom Bentley <tb...@redhat.com> wrote:
>
> Hi Sebb,
>
> I think this has been addressed for future releases by
> https://github.com/apache/kafka/pull/10203.

Thanks for the info. I hope that fixes it.

> AFAIU removing the Javadocs for
> previous releases would need to be done by someone on the PMC.

Yes, normally only PMC members can update the source at:

https://dist.apache.org/repos/dist/release/kafka/

If any from the PMC is available, please could they invoke:

svn rm https://dist.apache.org/repos/dist/release/kafka/2.6.1/javadoc/
and
svn rm https://dist.apache.org/repos/dist/release/kafka/2.7.0/javadoc/

Thanks,
Sebb.

> Kind regards,
>
> Tom
>
> On Wed, Mar 17, 2021 at 11:47 AM sebb <se...@gmail.com> wrote:
>
> > PING?
> >
> > On Sat, 13 Mar 2021 at 15:40, sebb <se...@gmail.com> wrote:
> > >
> > > Is anyone there?
> > >
> > > On Sat, 6 Mar 2021 at 11:33, sebb <se...@gmail.com> wrote:
> > > >
> > > > As the subject says: AFAICT the Kafka project is the only project
> > > > which publishes Javadocs as individual files on downloads.a.o.
> > > >
> > > > What is the use case for this?
> > > > The Javadocs are already published on the Kafka website.
> > > >
> > > > The mirror system relies on volunteers, and not all of them have lots
> > > > of disk space, so it is important to minimise what is published.
> > > > Additional files also increase the network traffic when synching (this
> > > > is a minor consideration, but it's still a waste of resources if the
> > > > files are unnecessary.)
> > > >
> > > > Sebb.
> >
> >

Re: Why are Javadocs published on downloads.apache.org?

Posted by Tom Bentley <tb...@redhat.com>.
Hi Sebb,

I think this has been addressed for future releases by
https://github.com/apache/kafka/pull/10203. AFAIU removing the Javadocs for
previous releases would need to be done by someone on the PMC.

Kind regards,

Tom

On Wed, Mar 17, 2021 at 11:47 AM sebb <se...@gmail.com> wrote:

> PING?
>
> On Sat, 13 Mar 2021 at 15:40, sebb <se...@gmail.com> wrote:
> >
> > Is anyone there?
> >
> > On Sat, 6 Mar 2021 at 11:33, sebb <se...@gmail.com> wrote:
> > >
> > > As the subject says: AFAICT the Kafka project is the only project
> > > which publishes Javadocs as individual files on downloads.a.o.
> > >
> > > What is the use case for this?
> > > The Javadocs are already published on the Kafka website.
> > >
> > > The mirror system relies on volunteers, and not all of them have lots
> > > of disk space, so it is important to minimise what is published.
> > > Additional files also increase the network traffic when synching (this
> > > is a minor consideration, but it's still a waste of resources if the
> > > files are unnecessary.)
> > >
> > > Sebb.
>
>

Re: Why are Javadocs published on downloads.apache.org?

Posted by sebb <se...@gmail.com>.
PING?

On Sat, 13 Mar 2021 at 15:40, sebb <se...@gmail.com> wrote:
>
> Is anyone there?
>
> On Sat, 6 Mar 2021 at 11:33, sebb <se...@gmail.com> wrote:
> >
> > As the subject says: AFAICT the Kafka project is the only project
> > which publishes Javadocs as individual files on downloads.a.o.
> >
> > What is the use case for this?
> > The Javadocs are already published on the Kafka website.
> >
> > The mirror system relies on volunteers, and not all of them have lots
> > of disk space, so it is important to minimise what is published.
> > Additional files also increase the network traffic when synching (this
> > is a minor consideration, but it's still a waste of resources if the
> > files are unnecessary.)
> >
> > Sebb.

Re: Why are Javadocs published on downloads.apache.org?

Posted by sebb <se...@gmail.com>.
Is anyone there?

On Sat, 6 Mar 2021 at 11:33, sebb <se...@gmail.com> wrote:
>
> As the subject says: AFAICT the Kafka project is the only project
> which publishes Javadocs as individual files on downloads.a.o.
>
> What is the use case for this?
> The Javadocs are already published on the Kafka website.
>
> The mirror system relies on volunteers, and not all of them have lots
> of disk space, so it is important to minimise what is published.
> Additional files also increase the network traffic when synching (this
> is a minor consideration, but it's still a waste of resources if the
> files are unnecessary.)
>
> Sebb.