You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@avro.apache.org by Clemens Vasters <cl...@microsoft.com.INVALID> on 2024/08/23 12:10:27 UTC

RE: Avro Docs - lots of 404 errors // AVRO-4041

Filed https://issues.apache.org/jira/browse/AVRO-4041

From: Clemens Vasters
Sent: Friday, August 23, 2024 2:06 PM
To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <ro...@decodable.co>
Subject: RE: Avro Docs - lots of 404 errors

The CNCF CloudEvents project has links to the Avro docs and they are all broken now, not even talking about links from Microsoft product docs, etc.

That's a huge issue.


From: Robin Moffatt via user <us...@avro.apache.org>>
Sent: Friday, August 23, 2024 1:29 PM
To: user@avro.apache.org<ma...@avro.apache.org>
Subject: Avro Docs - lots of 404 errors

Hi,

I noticed that https://avro.apache.org/docs/current/ has gone 404.

Checking the doc versions linked to from https://avro.apache.org/ only 1.12.0 works - all the others are 404
e.g.
https://avro.apache.org/docs/1.11.3/
https://avro.apache.org/docs/1.11.2/
https://avro.apache.org/docs/1.9.0/
etc
etc

Is this a known issue / is not, is there another place I should report it?

thanks,

Robin.

--
Robin Moffatt
Principal DevEx Engineer, Decodable


Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Martin Grigorov <mg...@apache.org>.
Hi Robin,

On Mon, Sep 2, 2024 at 1:15 PM Robin Moffatt <ro...@decodable.co.invalid>
wrote:

> Thanks for fixing this Fokko and Martin.
>
> The previous URL https://avro.apache.org/docs/current/ does now work, but
> redirects to /docs/++version++/ on which the title is Apache Avro™
> ++version++ Documentation.
> Not sure if this is a known issue (that "++version++" is exposed in this
> way) but mentioning it just in case.
>

AFAIK this is how it worked for at least a year.
++version++ means "the not yet released version" (from the main branch). I
think it has been chosen because it is easier to search and replace when
cutting a release.
Maybe we should rename it to "current", "development" or "snapshot"
version, but then the release manager should be really careful not to
replace something unrelated.



>
> thanks, Robin
>
>
>
>
> On Sun, 25 Aug 2024 at 21:19, Fokko Driesprong <fo...@apache.org> wrote:
>
> > Hi everyone,
> >
> > Thanks for your patience. Martin and I did some follow-up fixes to the
> > docs, and they should work again. There are still some cosmetic issues,
> but
> > all the versions should resolve again. Thanks again for the heads up on
> > this, let us know if something is still broken!
> >
> > Kind regards,
> > Fokko
> >
> > Op vr 23 aug 2024 om 14:16 schreef Fokko Driesprong <fo...@apache.org>:
> >
> >> Hey Robin, Clemens,
> >>
> >> Thanks for raising this, and we are aware of the issue. To point out,
> the
> >> docs for 1.11.2 and 1.11.3 we're just added this week, and we're
> working on
> >> fixing the build. That said, I fully agree that we should not break any
> >> historical links. Let me dig into this
> >>
> >> Kind regards,
> >> Fokko
> >>
> >> Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
> >> <cl...@microsoft.com.invalid>:
> >>
> >>> Filed https://issues.apache.org/jira/browse/AVRO-4041
> >>>
> >>> From: Clemens Vasters
> >>> Sent: Friday, August 23, 2024 2:06 PM
> >>> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
> >>> robin@decodable.co>
> >>> Subject: RE: Avro Docs - lots of 404 errors
> >>>
> >>> The CNCF CloudEvents project has links to the Avro docs and they are
> all
> >>> broken now, not even talking about links from Microsoft product docs,
> etc.
> >>>
> >>> That's a huge issue.
> >>>
> >>>
> >>> From: Robin Moffatt via user <user@avro.apache.org<mailto:
> >>> user@avro.apache.org>>
> >>> Sent: Friday, August 23, 2024 1:29 PM
> >>> To: user@avro.apache.org<ma...@avro.apache.org>
> >>> Subject: Avro Docs - lots of 404 errors
> >>>
> >>> Hi,
> >>>
> >>> I noticed that https://avro.apache.org/docs/current/ has gone 404.
> >>>
> >>> Checking the doc versions linked to from https://avro.apache.org/ only
> >>> 1.12.0 works - all the others are 404
> >>> e.g.
> >>> https://avro.apache.org/docs/1.11.3/
> >>> https://avro.apache.org/docs/1.11.2/
> >>> https://avro.apache.org/docs/1.9.0/
> >>> etc
> >>> etc
> >>>
> >>> Is this a known issue / is not, is there another place I should report
> >>> it?
> >>>
> >>> thanks,
> >>>
> >>> Robin.
> >>>
> >>> --
> >>> Robin Moffatt
> >>> Principal DevEx Engineer, Decodable
> >>>
> >>>
>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Martin Grigorov <mg...@apache.org>.
Hi Robin,

On Mon, Sep 2, 2024 at 1:15 PM Robin Moffatt <ro...@decodable.co.invalid>
wrote:

> Thanks for fixing this Fokko and Martin.
>
> The previous URL https://avro.apache.org/docs/current/ does now work, but
> redirects to /docs/++version++/ on which the title is Apache Avro™
> ++version++ Documentation.
> Not sure if this is a known issue (that "++version++" is exposed in this
> way) but mentioning it just in case.
>

AFAIK this is how it worked for at least a year.
++version++ means "the not yet released version" (from the main branch). I
think it has been chosen because it is easier to search and replace when
cutting a release.
Maybe we should rename it to "current", "development" or "snapshot"
version, but then the release manager should be really careful not to
replace something unrelated.



>
> thanks, Robin
>
>
>
>
> On Sun, 25 Aug 2024 at 21:19, Fokko Driesprong <fo...@apache.org> wrote:
>
> > Hi everyone,
> >
> > Thanks for your patience. Martin and I did some follow-up fixes to the
> > docs, and they should work again. There are still some cosmetic issues,
> but
> > all the versions should resolve again. Thanks again for the heads up on
> > this, let us know if something is still broken!
> >
> > Kind regards,
> > Fokko
> >
> > Op vr 23 aug 2024 om 14:16 schreef Fokko Driesprong <fo...@apache.org>:
> >
> >> Hey Robin, Clemens,
> >>
> >> Thanks for raising this, and we are aware of the issue. To point out,
> the
> >> docs for 1.11.2 and 1.11.3 we're just added this week, and we're
> working on
> >> fixing the build. That said, I fully agree that we should not break any
> >> historical links. Let me dig into this
> >>
> >> Kind regards,
> >> Fokko
> >>
> >> Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
> >> <cl...@microsoft.com.invalid>:
> >>
> >>> Filed https://issues.apache.org/jira/browse/AVRO-4041
> >>>
> >>> From: Clemens Vasters
> >>> Sent: Friday, August 23, 2024 2:06 PM
> >>> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
> >>> robin@decodable.co>
> >>> Subject: RE: Avro Docs - lots of 404 errors
> >>>
> >>> The CNCF CloudEvents project has links to the Avro docs and they are
> all
> >>> broken now, not even talking about links from Microsoft product docs,
> etc.
> >>>
> >>> That's a huge issue.
> >>>
> >>>
> >>> From: Robin Moffatt via user <user@avro.apache.org<mailto:
> >>> user@avro.apache.org>>
> >>> Sent: Friday, August 23, 2024 1:29 PM
> >>> To: user@avro.apache.org<ma...@avro.apache.org>
> >>> Subject: Avro Docs - lots of 404 errors
> >>>
> >>> Hi,
> >>>
> >>> I noticed that https://avro.apache.org/docs/current/ has gone 404.
> >>>
> >>> Checking the doc versions linked to from https://avro.apache.org/ only
> >>> 1.12.0 works - all the others are 404
> >>> e.g.
> >>> https://avro.apache.org/docs/1.11.3/
> >>> https://avro.apache.org/docs/1.11.2/
> >>> https://avro.apache.org/docs/1.9.0/
> >>> etc
> >>> etc
> >>>
> >>> Is this a known issue / is not, is there another place I should report
> >>> it?
> >>>
> >>> thanks,
> >>>
> >>> Robin.
> >>>
> >>> --
> >>> Robin Moffatt
> >>> Principal DevEx Engineer, Decodable
> >>>
> >>>
>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Robin Moffatt <ro...@decodable.co.INVALID>.
Thanks for fixing this Fokko and Martin.

The previous URL https://avro.apache.org/docs/current/ does now work, but
redirects to /docs/++version++/ on which the title is Apache Avro™
++version++ Documentation.
Not sure if this is a known issue (that "++version++" is exposed in this
way) but mentioning it just in case.

thanks, Robin




On Sun, 25 Aug 2024 at 21:19, Fokko Driesprong <fo...@apache.org> wrote:

> Hi everyone,
>
> Thanks for your patience. Martin and I did some follow-up fixes to the
> docs, and they should work again. There are still some cosmetic issues, but
> all the versions should resolve again. Thanks again for the heads up on
> this, let us know if something is still broken!
>
> Kind regards,
> Fokko
>
> Op vr 23 aug 2024 om 14:16 schreef Fokko Driesprong <fo...@apache.org>:
>
>> Hey Robin, Clemens,
>>
>> Thanks for raising this, and we are aware of the issue. To point out, the
>> docs for 1.11.2 and 1.11.3 we're just added this week, and we're working on
>> fixing the build. That said, I fully agree that we should not break any
>> historical links. Let me dig into this
>>
>> Kind regards,
>> Fokko
>>
>> Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
>> <cl...@microsoft.com.invalid>:
>>
>>> Filed https://issues.apache.org/jira/browse/AVRO-4041
>>>
>>> From: Clemens Vasters
>>> Sent: Friday, August 23, 2024 2:06 PM
>>> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
>>> robin@decodable.co>
>>> Subject: RE: Avro Docs - lots of 404 errors
>>>
>>> The CNCF CloudEvents project has links to the Avro docs and they are all
>>> broken now, not even talking about links from Microsoft product docs, etc.
>>>
>>> That's a huge issue.
>>>
>>>
>>> From: Robin Moffatt via user <user@avro.apache.org<mailto:
>>> user@avro.apache.org>>
>>> Sent: Friday, August 23, 2024 1:29 PM
>>> To: user@avro.apache.org<ma...@avro.apache.org>
>>> Subject: Avro Docs - lots of 404 errors
>>>
>>> Hi,
>>>
>>> I noticed that https://avro.apache.org/docs/current/ has gone 404.
>>>
>>> Checking the doc versions linked to from https://avro.apache.org/ only
>>> 1.12.0 works - all the others are 404
>>> e.g.
>>> https://avro.apache.org/docs/1.11.3/
>>> https://avro.apache.org/docs/1.11.2/
>>> https://avro.apache.org/docs/1.9.0/
>>> etc
>>> etc
>>>
>>> Is this a known issue / is not, is there another place I should report
>>> it?
>>>
>>> thanks,
>>>
>>> Robin.
>>>
>>> --
>>> Robin Moffatt
>>> Principal DevEx Engineer, Decodable
>>>
>>>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Robin Moffatt via user <us...@avro.apache.org>.
Thanks for fixing this Fokko and Martin.

The previous URL https://avro.apache.org/docs/current/ does now work, but
redirects to /docs/++version++/ on which the title is Apache Avro™
++version++ Documentation.
Not sure if this is a known issue (that "++version++" is exposed in this
way) but mentioning it just in case.

thanks, Robin




On Sun, 25 Aug 2024 at 21:19, Fokko Driesprong <fo...@apache.org> wrote:

> Hi everyone,
>
> Thanks for your patience. Martin and I did some follow-up fixes to the
> docs, and they should work again. There are still some cosmetic issues, but
> all the versions should resolve again. Thanks again for the heads up on
> this, let us know if something is still broken!
>
> Kind regards,
> Fokko
>
> Op vr 23 aug 2024 om 14:16 schreef Fokko Driesprong <fo...@apache.org>:
>
>> Hey Robin, Clemens,
>>
>> Thanks for raising this, and we are aware of the issue. To point out, the
>> docs for 1.11.2 and 1.11.3 we're just added this week, and we're working on
>> fixing the build. That said, I fully agree that we should not break any
>> historical links. Let me dig into this
>>
>> Kind regards,
>> Fokko
>>
>> Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
>> <cl...@microsoft.com.invalid>:
>>
>>> Filed https://issues.apache.org/jira/browse/AVRO-4041
>>>
>>> From: Clemens Vasters
>>> Sent: Friday, August 23, 2024 2:06 PM
>>> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
>>> robin@decodable.co>
>>> Subject: RE: Avro Docs - lots of 404 errors
>>>
>>> The CNCF CloudEvents project has links to the Avro docs and they are all
>>> broken now, not even talking about links from Microsoft product docs, etc.
>>>
>>> That's a huge issue.
>>>
>>>
>>> From: Robin Moffatt via user <user@avro.apache.org<mailto:
>>> user@avro.apache.org>>
>>> Sent: Friday, August 23, 2024 1:29 PM
>>> To: user@avro.apache.org<ma...@avro.apache.org>
>>> Subject: Avro Docs - lots of 404 errors
>>>
>>> Hi,
>>>
>>> I noticed that https://avro.apache.org/docs/current/ has gone 404.
>>>
>>> Checking the doc versions linked to from https://avro.apache.org/ only
>>> 1.12.0 works - all the others are 404
>>> e.g.
>>> https://avro.apache.org/docs/1.11.3/
>>> https://avro.apache.org/docs/1.11.2/
>>> https://avro.apache.org/docs/1.9.0/
>>> etc
>>> etc
>>>
>>> Is this a known issue / is not, is there another place I should report
>>> it?
>>>
>>> thanks,
>>>
>>> Robin.
>>>
>>> --
>>> Robin Moffatt
>>> Principal DevEx Engineer, Decodable
>>>
>>>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Fokko Driesprong <fo...@apache.org>.
Hi everyone,

Thanks for your patience. Martin and I did some follow-up fixes to the
docs, and they should work again. There are still some cosmetic issues, but
all the versions should resolve again. Thanks again for the heads up on
this, let us know if something is still broken!

Kind regards,
Fokko

Op vr 23 aug 2024 om 14:16 schreef Fokko Driesprong <fo...@apache.org>:

> Hey Robin, Clemens,
>
> Thanks for raising this, and we are aware of the issue. To point out, the
> docs for 1.11.2 and 1.11.3 we're just added this week, and we're working on
> fixing the build. That said, I fully agree that we should not break any
> historical links. Let me dig into this
>
> Kind regards,
> Fokko
>
> Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
> <cl...@microsoft.com.invalid>:
>
>> Filed https://issues.apache.org/jira/browse/AVRO-4041
>>
>> From: Clemens Vasters
>> Sent: Friday, August 23, 2024 2:06 PM
>> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
>> robin@decodable.co>
>> Subject: RE: Avro Docs - lots of 404 errors
>>
>> The CNCF CloudEvents project has links to the Avro docs and they are all
>> broken now, not even talking about links from Microsoft product docs, etc.
>>
>> That's a huge issue.
>>
>>
>> From: Robin Moffatt via user <user@avro.apache.org<mailto:
>> user@avro.apache.org>>
>> Sent: Friday, August 23, 2024 1:29 PM
>> To: user@avro.apache.org<ma...@avro.apache.org>
>> Subject: Avro Docs - lots of 404 errors
>>
>> Hi,
>>
>> I noticed that https://avro.apache.org/docs/current/ has gone 404.
>>
>> Checking the doc versions linked to from https://avro.apache.org/ only
>> 1.12.0 works - all the others are 404
>> e.g.
>> https://avro.apache.org/docs/1.11.3/
>> https://avro.apache.org/docs/1.11.2/
>> https://avro.apache.org/docs/1.9.0/
>> etc
>> etc
>>
>> Is this a known issue / is not, is there another place I should report it?
>>
>> thanks,
>>
>> Robin.
>>
>> --
>> Robin Moffatt
>> Principal DevEx Engineer, Decodable
>>
>>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Fokko Driesprong <fo...@apache.org>.
Hi everyone,

Thanks for your patience. Martin and I did some follow-up fixes to the
docs, and they should work again. There are still some cosmetic issues, but
all the versions should resolve again. Thanks again for the heads up on
this, let us know if something is still broken!

Kind regards,
Fokko

Op vr 23 aug 2024 om 14:16 schreef Fokko Driesprong <fo...@apache.org>:

> Hey Robin, Clemens,
>
> Thanks for raising this, and we are aware of the issue. To point out, the
> docs for 1.11.2 and 1.11.3 we're just added this week, and we're working on
> fixing the build. That said, I fully agree that we should not break any
> historical links. Let me dig into this
>
> Kind regards,
> Fokko
>
> Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
> <cl...@microsoft.com.invalid>:
>
>> Filed https://issues.apache.org/jira/browse/AVRO-4041
>>
>> From: Clemens Vasters
>> Sent: Friday, August 23, 2024 2:06 PM
>> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
>> robin@decodable.co>
>> Subject: RE: Avro Docs - lots of 404 errors
>>
>> The CNCF CloudEvents project has links to the Avro docs and they are all
>> broken now, not even talking about links from Microsoft product docs, etc.
>>
>> That's a huge issue.
>>
>>
>> From: Robin Moffatt via user <user@avro.apache.org<mailto:
>> user@avro.apache.org>>
>> Sent: Friday, August 23, 2024 1:29 PM
>> To: user@avro.apache.org<ma...@avro.apache.org>
>> Subject: Avro Docs - lots of 404 errors
>>
>> Hi,
>>
>> I noticed that https://avro.apache.org/docs/current/ has gone 404.
>>
>> Checking the doc versions linked to from https://avro.apache.org/ only
>> 1.12.0 works - all the others are 404
>> e.g.
>> https://avro.apache.org/docs/1.11.3/
>> https://avro.apache.org/docs/1.11.2/
>> https://avro.apache.org/docs/1.9.0/
>> etc
>> etc
>>
>> Is this a known issue / is not, is there another place I should report it?
>>
>> thanks,
>>
>> Robin.
>>
>> --
>> Robin Moffatt
>> Principal DevEx Engineer, Decodable
>>
>>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Fokko Driesprong <fo...@apache.org>.
Hey Robin, Clemens,

Thanks for raising this, and we are aware of the issue. To point out, the
docs for 1.11.2 and 1.11.3 we're just added this week, and we're working on
fixing the build. That said, I fully agree that we should not break any
historical links. Let me dig into this

Kind regards,
Fokko

Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
<cl...@microsoft.com.invalid>:

> Filed https://issues.apache.org/jira/browse/AVRO-4041
>
> From: Clemens Vasters
> Sent: Friday, August 23, 2024 2:06 PM
> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
> robin@decodable.co>
> Subject: RE: Avro Docs - lots of 404 errors
>
> The CNCF CloudEvents project has links to the Avro docs and they are all
> broken now, not even talking about links from Microsoft product docs, etc.
>
> That's a huge issue.
>
>
> From: Robin Moffatt via user <user@avro.apache.org<mailto:
> user@avro.apache.org>>
> Sent: Friday, August 23, 2024 1:29 PM
> To: user@avro.apache.org<ma...@avro.apache.org>
> Subject: Avro Docs - lots of 404 errors
>
> Hi,
>
> I noticed that https://avro.apache.org/docs/current/ has gone 404.
>
> Checking the doc versions linked to from https://avro.apache.org/ only
> 1.12.0 works - all the others are 404
> e.g.
> https://avro.apache.org/docs/1.11.3/
> https://avro.apache.org/docs/1.11.2/
> https://avro.apache.org/docs/1.9.0/
> etc
> etc
>
> Is this a known issue / is not, is there another place I should report it?
>
> thanks,
>
> Robin.
>
> --
> Robin Moffatt
> Principal DevEx Engineer, Decodable
>
>

Re: Avro Docs - lots of 404 errors // AVRO-4041

Posted by Fokko Driesprong <fo...@apache.org>.
Hey Robin, Clemens,

Thanks for raising this, and we are aware of the issue. To point out, the
docs for 1.11.2 and 1.11.3 we're just added this week, and we're working on
fixing the build. That said, I fully agree that we should not break any
historical links. Let me dig into this

Kind regards,
Fokko

Op vr 23 aug 2024 om 14:12 schreef Clemens Vasters
<cl...@microsoft.com.invalid>:

> Filed https://issues.apache.org/jira/browse/AVRO-4041
>
> From: Clemens Vasters
> Sent: Friday, August 23, 2024 2:06 PM
> To: 'user@avro.apache.org' <us...@avro.apache.org>; 'Robin Moffatt' <
> robin@decodable.co>
> Subject: RE: Avro Docs - lots of 404 errors
>
> The CNCF CloudEvents project has links to the Avro docs and they are all
> broken now, not even talking about links from Microsoft product docs, etc.
>
> That's a huge issue.
>
>
> From: Robin Moffatt via user <user@avro.apache.org<mailto:
> user@avro.apache.org>>
> Sent: Friday, August 23, 2024 1:29 PM
> To: user@avro.apache.org<ma...@avro.apache.org>
> Subject: Avro Docs - lots of 404 errors
>
> Hi,
>
> I noticed that https://avro.apache.org/docs/current/ has gone 404.
>
> Checking the doc versions linked to from https://avro.apache.org/ only
> 1.12.0 works - all the others are 404
> e.g.
> https://avro.apache.org/docs/1.11.3/
> https://avro.apache.org/docs/1.11.2/
> https://avro.apache.org/docs/1.9.0/
> etc
> etc
>
> Is this a known issue / is not, is there another place I should report it?
>
> thanks,
>
> Robin.
>
> --
> Robin Moffatt
> Principal DevEx Engineer, Decodable
>
>