Update or remove broken links (#1935)

stevepiercy · web-flow · commit d7c6348eb29a · 2025-04-07T21:44:16.000-07:00
diff --git a/docs/backend/workflows.md b/docs/backend/workflows.md
@@ -12,7 +12,7 @@ myst:
 # Workflows
 
 ```{seealso}
-See the training {ref}`training:workflow-label`.
+See the training {ref}`training-2024:workflow-label`.
 ```
 
 ```{todo}
diff --git a/docs/conf.py b/docs/conf.py
@@ -79,7 +79,6 @@
 # Ignore localhost
 linkcheck_ignore = [
     # Ignore local and example URLs
-    r"http://0.0.0.0",
     r"http://127.0.0.1",
     r"http://localhost",
     r"http://yoursite",
@@ -89,26 +88,19 @@
     # Ignore pages that require authentication
     r"https://github.com/orgs/plone/teams/",  # requires auth
     r"https://github.com/plone/documentation/issues/new",  # requires auth
-    r"https://github.com/plone/volto/issues/new/choose",  # requires auth
-    r"https://opensource.org/",  # requires auth
     # Ignore github.com pages with anchors
     r"https://github.com/.*#.*",
-    # Ignore github.com searches
-    r"https://github.com/search",
-    # Ignore GitHub 429 Client Error: Too Many Requests for url
-    r"https://github.com/collective/plone.app.locales/commits/master/",
     # Ignore rate limiting by github.com
     r"https://github.com/plone/volto/issues",
     r"https://github.com/plone/volto/pull",
     # Ignore other specific anchors
     r"https://coveralls.io/repos/github/plone/plone.restapi/badge.svg\?branch=main",  # plone.restapi
-    r"https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS/Errors#Identifying_the_issue",  # volto
-    r"https://docs.cypress.io/guides/references/migration-guide#Migrating-to-Cypress-version-10-0",  # volto
+    r"https://hosted.weblate.org/accounts/profile/#notifications",
     r"https://browsersl.ist/#",  # volto
     # Ignore unreliable sites
-    r"https://web.archive.org/",
-    r"https://www.gnu.org/",  # Consider removal when upgrading Sphinx
-    r"http://z3c.pt",  # fluke where Sphinx interprets this as a URL
+    r"https://.*.gnu.org/",
+    # fluke where Sphinx interprets this as a URL
+    r"http://z3c.pt",
 ]
 linkcheck_allowed_redirects = {
     # All HTTP redirections from the source URI to the canonical URI will be treated as "working".
diff --git a/docs/contributing/core/release.md b/docs/contributing/core/release.md
@@ -35,10 +35,6 @@ All files mentioned in this list may be written in Markdown or reStructuredText
     The `.mo` files can be created with the `zest.pocompile` add-on, which should be installed together with `zest.releaser`.
 -   `.gitignore` and `MANIFEST.in` must reflect the files going in to the package (must include page template and `.po` files).
 
-```{seealso}
-[High quality automated package releases for Python with `zest.releaser`](https://opensourcehacker.com/2012/08/14/high-quality-automated-package-releases-for-python-with-zest-releaser/).
-```
-
 
 ## Special packages
 
diff --git a/docs/contributing/documentation/authors.md b/docs/contributing/documentation/authors.md
@@ -315,7 +315,7 @@ This renders in the HTML `<head>` section as follows.
 <meta content="Plone, Documentation, SEO, meta, Vale, spell, grammar, style, check, linkcheck, lexer" name="keywords" />
 ```
 
-Additional {term}`Open Graph` metadata is implemented through the Sphinx extension [`sphinxext-opengraph`](https://github.com/wpilibsuite/sphinxext-opengraph) and the [MyST `html_meta` directive](https://myst-parser.readthedocs.io/en/latest/configuration.html#setting-html-metadata), which resolves to the [Docutils `meta` directive](https://docutils.sourceforge.io/docs/ref/rst/directives.html#metadata).
+Additional {term}`Open Graph` metadata is implemented through the Sphinx extension [`sphinxext-opengraph`](https://github.com/sphinx-doc/sphinxext-opengraph) and the [MyST `html_meta` directive](https://myst-parser.readthedocs.io/en/latest/configuration.html#setting-html-metadata), which resolves to the [Docutils `meta` directive](https://docutils.sourceforge.io/docs/ref/rst/directives.html#metadata).
 See the site-wide configuration in {file}`conf.py`.
 
 
diff --git a/docs/contributing/first-time.md b/docs/contributing/first-time.md
@@ -42,11 +42,11 @@ As a first-time contributor to Plone on GitHub, we expect that you have:
 -   read and followed the guidance on the pages under {doc}`/contributing/index` both for Plone in general and for the specific project to which you want to contribute, as well as all the guidance on this page
 -   worked through some trainings, such as the recommended:
     -   {doc}`training:mastering-plone/index`
-    -   {doc}`training:volto-customization/index`
     -   {doc}`training:customizing-volto-light-theme/index`
-    -   {doc}`training:voltohandson/index`
-    -   {doc}`training:voltoaddons/index`
+    -   {doc}`training:volto-customization/index`
     -   {doc}`training:plone-deployment/index`
+    -   {doc}`training-2024:voltohandson/index` (archived)
+    -   {doc}`training-2024:voltoaddons/index` (archived)
 -   a sincere interest to contribute to Plone and become an ongoing contributing member of our organization
 -   a GitHub account
 -   basic knowledge of using git and GitHub
