Fixed this permanently in b1b687be
<https://github.com/apache/logging-log4j2/commit/b1b687be624ca02149edd5c27c030db470dca7b0>
using
HTML-based redirects. I have tested it locally, but did not deploy to the
website. This will ensure that old links will still work next time somebody
generates the website.

Depending on the feedback from users, we might pivot our approach.

On Wed, Feb 22, 2023 at 5:50 PM Ralph Goers <rgo...@apache.org> wrote:

> Answering right now my preference is number 1 however that could change if
> no other complaints are made regarding the web site. We eliminated a number
> of project reports that users might yet complain about. So adding in the
> module directories makes it much easier to restore missing reports should
> that be needed. However, if no one complains then my answer would probably
> change.
>
> All that said, I am not sure using .htaccess the way you describe will be
> sufficient as it only solves the problem for the latest release. Anyone who
> references a specific release will still have a bad link.
>
> Ralph
>
> On 2023/02/22 09:28:24 Volkan Yazıcı wrote:
> > While fixing the javadoc for the 2.20.0 release, I renamed the path from
> > `/<module>/apidocs` to `/javadoc/<module>`. As the user issue below
> > explains, this got some people angry. I have already temporarily fixed
> the
> > issue by creating directory symlinks. For a permanent solution, I see two
> > options:
> >
> >    1. Configure the `javadoc-maven-plugin` to output to
> `/<module>/apidocs`
> >    instead of `/javadoc/<module>`. The reason I am not happy with this
> >    approach is that it actually was like that since that is how
> >    `maven-site-plugin` works and it is not aligned with the website
> directory
> >    structure. Nonetheless, it is doable.
> >    2. Create an `.htaccess` entry *permanently* redirecting
> >    `2.x/<module>/apidocs` to `2.x/javadoc/<module>`. I am sort of
> inclined
> >    with this fix, since we can stick to our directory structure.
> >
> > Thoughts?
> >
> > ---------- Forwarded message ---------
> > From: Alexander Brandes <notificati...@github.com>
> > Date: Wed, Feb 22, 2023 at 9:36 AM
> > Subject: [apache/logging-log4j2] Broken Javadoc URL (Issue #1284)
> > To: apache/logging-log4j2 <logging-log...@noreply.github.com>
> > Cc: Subscribed <subscri...@noreply.github.com>
> >
> >
> > Hey,
> >
> > It appears that a recent changed forced a change of the Javadoc URL from
> > https://logging.apache.org/log4j/2.x/log4j-api/apidocs/ to
> > https://logging.apache.org/log4j/2.x/javadoc/log4j-api/index.html.
> >
> > Is there a particular reason why this was changed without a redirect
> > pointing to the new location? This change affects hundreds
> > <
> https://cs.github.com/?scopeName=All+repos&scope=&q=https%3A%2F%2Flogging.apache.org%2Flog4j%2F2.x%2Flog4j-api%2Fapidocs%2F+NOT+lang%3Ahtml
> >
> > of files in open source projects, now left behind broken.
> >
> > Some builds may also fail because a build tool can no longer obtain the
> > file from the old location:
> >
> > Error fetching URL:
> > https://logging.apache.org/log4j/2.x/log4j-api/apidocs/
> > (java.io.FileNotFoundException:
> > https://logging.apache.org/log4j/2.x/log4j-api/apidocs/package-list)
> >
> > —
> > Reply to this email directly, view it on GitHub
> > <https://github.com/apache/logging-log4j2/issues/1284>, or unsubscribe
> > <
> https://github.com/notifications/unsubscribe-auth/AAARTSI5PVTEJOFKU66PM43WYXFZ3ANCNFSM6AAAAAAVEAR5SA
> >
> > .
> > You are receiving this because you are subscribed to this thread.Message
> > ID: <apache/logging-log4j2/issues/1...@github.com>
> >
>

Reply via email to