Linkcheck 2024 11 24 (#1793)

* Fix linkcheck
- html_use_opensearch value must not have a trailing slash
- Clean up comments

* Fix links to latest trainings

docs/conf.py

@@ -100,16 +100,16 @@
     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",
+    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
     # Ignore unreliable sites
     r"https://web.archive.org/",
-    r"https://www.youtube.com/playlist",  # volto, TODO remove after installing sphinxcontrib.youtube
     r"http://z3c.pt",  # fluke where Sphinx interprets this as a URL
 ]
-linkcheck_allowed_redirects = {  # TODO: Confirm usage of linkcheck_allowed_redirects
+linkcheck_allowed_redirects = {
     # All HTTP redirections from the source URI to the canonical URI will be treated as "working".
-    r"https://chrome\.google\.com/webstore/detail/.*": r"https://consent\.google\.com/.*",
+    # Example
+    # r"https://chrome\.google\.com/webstore/detail/.*": r"https://consent\.google\.com/.*",
 }
 linkcheck_anchors = True
 linkcheck_timeout = 5

docs/contributing/first-time.md

@@ -41,9 +41,10 @@ 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`
 -   a sincere interest to contribute to Plone and become an ongoing contributing member of our organization
 -   a GitHub account