Invalid Javadoc links to https://javaee.github.io/jakartamail/...

[Fiouz]

Describe the bug API documentation links to external material lead to 404 HTTP errors.

To Reproduce Steps to reproduce the behavior:

1. Read link from https://github.com/eclipse-ee4j/mail/blob/fedabffb18abf8f4730f75d92e28980e20d0ad82/api/src/main/java/jakarta/mail/package-info.java#L28
2. https://javaee.github.io/jakartamail/docs/JakartaMail-1.6.pdf does not exist (and the filename does not match the API version neither btw)
3. Read links from https://github.com/eclipse-ee4j/mail/blob/fedabffb18abf8f4730f75d92e28980e20d0ad82/api/src/main/java/jakarta/mail/package-info.java#L58-L61
4. https://javaee.github.io/jakartamail/FAQ.html & https://javaee.github.io/jakartamail/ lead to 404s

Expected behavior The Javadoc content to refer to existing material.

Screenshots If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Mail server:

• Protocol being used: [e.g. smtp, imap, pop3, etc.]
• Vendor/product: [e.g. Microsoft Exchange]
• Mail service URL: [e.g. gmail.com]

Additional context Add any other context about the problem here.

[rybak]

Stumbled upon the same problem. Overall, there are six URLs that point to https://javaee.github.io:

https://github.com/search?q=repo%3Ajakartaee%2Fmail-api+javaee.github&type=code

---

In my case, I wanted to go to the FAQ about javax.mail (old URL https://javaee.github.io/jakartamail/FAQ.html). The best match of new URL is https://jakartaee.github.io/mail-api/FAQ.

I've also found an old page on oracle.com: https://www.oracle.com/technetwork/java/javamail/faq/index.html