Investigate / resolve link errors

[mjang]

Describe the bug

CI/CD job https://github.com/nginx/documentation/actions/runs/14190446169/job/39753719002 shows link errors:

404 Not Found: 22 instances
301 Moved Permanently: 13 instances

Collected in the following file:

1_nginx-plus.txt

To reproduce

Rerun CI/CD job

Expected behavior

Minimum: no 404s
Ideal: no 301s either

Note

Possible "Good first issue" if I can figure out a way to "explain" the process

• Dependency on internal work -- issue # 328 on our docs-platform
• With that work, we'll have "Edit this page" links on each of our production pages
• We can then point users to such pages

[FaithKovi]

Hello @mjang
I would like to work on this issue.

[mjang]

Hello @mjang I would like to work on this issue.

Great! I've assigned the issue to you. I look forward to your contributions!

[FaithKovi]

Hello @mjang , I was able to look at the workflow file for the link checker and also the corresponding links throwing the errors.
Since Nginx is now part of F5, all previous Nginx links have moved to F5.com. Also, within F5, some links have been moved from the initial ones that were used.

Proposed solution: Replacing the link on the workflow file with the correct one would help resolve this.
Let me know what you think.

[mjang]

@FaithKovi That would be great!

When I've researched these types of issues, I've:

• Searched for the original link through the Wayback Machine
• Found an equivalent with the same content, either at docs.nginx.com or f5.com

Example, here's an excerpt from the linked 1_nginx_plus.txt file:

2025-04-01T08:07:26.2637404Z URL        `https://www.nginx.com/solutions/load-balancing/'
2025-04-01T08:07:26.2638096Z Name       `Load balancing'
2025-04-01T08:07:26.2638677Z Parent URL https://docs.nginx.com/nginx/admin-guide/load-balancer/tcp-udp-load-balancer/, line 3465, col 9   
2025-04-01T08:07:26.2639370Z Real URL   https://www.f5.com/solutions/load-balancing
2025-04-01T08:07:26.2640011Z Check time 2.218 seconds
2025-04-01T08:07:26.2640483Z Size       1KB
2025-04-01T08:07:26.2640868Z Warning    [http-redirected] Redirected to
2025-04-01T08:07:26.2641269Z            `https://www.f5.com/solutions/load-balancing/' status:
2025-04-01T08:07:26.2641683Z            301 Moved Permanently.
2025-04-01T08:07:26.2641998Z            [http-redirected] Redirected to
2025-04-01T08:07:26.2642409Z            `https://www.f5.com/solutions/load-balancing' status:
2025-04-01T08:07:26.2642798Z            301 Moved Permanently.
2025-04-01T08:07:26.2643091Z Result     Error: 404 Not Found

The broken link is at the following URL: https://www.nginx.com/solutions/load-balancing/
The Name of the link is Load balancing
You can find the link at the Parent URL, https://docs.nginx.com/nginx/admin-guide/load-balancer/tcp-udp-load-balancer/

Based on the context, I know I'm looking for a link to docs.nginx.com or f5.com that describes load balancers. With some "googling," I find https://www.f5.com/glossary/load-balancer

Solution: propose a PR to replace the link in https://docs.nginx.com/nginx/admin-guide/load-balancer/tcp-udp-load-balancer/ with https://www.f5.com/glossary/load-balancer.

[ajollymo]

• Line 18 Did not locate a compatible link to an article or documentation (Migrating Layer 7 logic).
• Line 33 Did not locate a compatible link to an article or documentation (Advanced Activity Monitoring).
• Line 34 Did not locate a compatible link to an article or documentation (Management and real-time configuration changes).

[y82]

Most of the links were fixed after QE Linkchecker reports:
#1283
#1169
#1131

It would be good to run the checker again to verify the fixed urls and get the list of not fixed

[y82]