Problem: some links in the docs are outdated as of Nov 2023

[eviau-artefactual]

Version of the documentation

1.15

Page (and section, if applicable) where the issue occurs

The documentation in general - see the appendix for a list of links to fix.

Description of the issue

Using Sphinx linkchecker by running make linkcheck in the repo, I was able to identify a few links that don't resolve and aren't redirected to anywhere. See the appendix for the complete list.

Suggested fix

Some of them are probably typos or are missing a www. ... some others might require searching a bit... I can get started and update with comments and PRs as needed.

---

For Artefactual use:

Before you close this issue, you must check off the following:

• All pull requests related to this issue are properly linked
• All pull requests related to this issue have been merged
• Details about this issue have been added to the release notes (if applicable)

---

Appendix - list of links

• (admin-manual/installation-setup/installation/installation: line 1) broken https://github.com/artefactual/archivematica/tree/qa/1.x/hack#docker-and-mac - Anchor 'docker-and-mac' not found --- see Problem: some links that referes to .md files hosted on GitHub use anchors that go as unresolved in linkcheck #1646
• (admin-manual/installation-setup/installation/installation: line 1) broken https://github.com/artefactual/archivematica/tree/qa/1.x/hack#docker-and-linux - Anchor 'docker-and-linux' not found --- see Problem: some links that referes to .md files hosted on GitHub use anchors that go as unresolved in linkcheck #1646
• (getting-started/overview/external-tools: line 130) broken https://pkgs.org/download/nfs-common - 402 Client Error: Payment Required for url: https://pkgs.org/download/nfs-common : should it be https://packages.ubuntu.com/jammy/nfs-common ? --- see Problem: nfs-common URL resolve but requires payment #1648
• (getting-started/overview/external-tools: line 164) broken https://opensource.org/licenses/cpl1.0.php - 404 Client Error: Not Found for url: https://opensource.org/licenses/cpl1.0.php --- see artefactual/archivematica-docs@6211157
• (admin-manual/installation-setup/customization/scaling-archivematica: line 99) broken https://raw.githubusercontent.com/artefactual-labs/am-packbuild/qa/1.x/rpm/archivematica/etc/archivematica-mcp-client.service - 404 Client Error: Not Found for url: https://raw.githubusercontent.com/artefactual-labs/am-packbuild/qa/1.x/rpm/archivematica/etc/archivematica-mcp-client.service --- see Problem: not sure what a link now refers to - MCPClient unit file #1649
• (admin-manual/installation-setup/customization/dashboard-config: line 298) broken www.accesstomemory.org - I think the https:// is missing
• (admin-manual/installation-setup/customization/antivirus-admin: line 98) broken https://bugzilla.clamav.net/show_bug.cgi?id=11958 - HTTPSConnectionPool(host='bugzilla.clamav.net', port=443): Max retries exceeded with url: /show_bug.cgi?id=11958 (Caused by ConnectTimeoutError(<urllib3.connection.HTTPSConnection object at 0x7f1807abacb0>, 'Connection to bugzilla.clamav.net timed out. (connect timeout=None)')) - see Problem: outdated link for an external bug - ClamAV #1645
• (admin-manual/installation-setup/integrations/integrations: line 51) broken https://wiki.dlib.indiana.edu/display/VarVideo/Archivematica+for+Avalon - HTTPSConnectionPool(host='wiki.dlib.indiana.edu', port=443): Max retries exceeded with url: /display/VarVideo/Archivematica+for+Avalon (Caused by ConnectTimeoutError(<urllib3.connection.HTTPSConnection object at 0x7f1807684a60>, 'Connection to wiki.dlib.indiana.edu timed out. (connect timeout=None)')) --- see artefactual/archivematica-docs@1b6d3e7
• Problem: the page refering to the TRAC review tool is out of date. #1650
• Problem: the link to Transifex returns a 404 #1651

There are a few others but although Sphinx report them as broken, the links returned valid content when I clicked on them - I am not adding them to this list.

[eviau-artefactual]

I think the other links will require a bit of detective work to find the adequate replacement... I will do my best, and might update this issue with questions in the next few days.

[eviau-artefactual]

Not sure why/how I closed this. I am confused.

[eviau-artefactual]

Current status: I am updating the links that can be updated in the PR 433 - if some more discussion is needed, I am going to link relevant Issues-PRs.

It might be a bit confusing but we will figure it out :)

[eviau-artefactual]

This should be the remaining link to be fixed, judging from the state of PRs and Issues and the job that just ran - https://github.com/artefactual/archivematica-docs/actions/runs/7992620973/job/21826539107 :

• (getting-started/overview/external-tools: line 148) broken https://linux.die.net/man/1/rsync - 403 Client Error: Forbidden for url: https://linux.die.net/man/1/rsync

[eviau-artefactual]

Related: #1647

[eviau-artefactual]

And to help us find failing URLs in the future, we will merge this PR (artefactual/archivematica-docs#439) to solve this issue( #708)

Currently Gearman.org isn't resolving and we believe it is only temporary: artefactual/archivematica-docs#452

[eviau-artefactual]

There are no currently outdated links in 1.15 ✨

Closing this issue.