Merge pull request #856 from plone/linkcheck-2024-10-09

Fix broken links, set linkcheck_rate_limit_timeout=10

docs/conf.py

@@ -94,6 +94,7 @@
     r"http://127.0.0.1",
     r"http://example.com",
     r"https://github.com/plone/training/issues/new/choose",  # requires auth
+    r"https://github.com/search",  # always rate limited, causes linkcheck to stall
     r"https://docs.github.com/en/get-started/.*",  # GitHub docs require auth
     r"https://github.com/plone/mockup/blob/master/mockup/.jshintrc",  # TODO: remove when javascript/development-process.md is updated. See https://github.com/plone/training/issues/611
     r"https://www.dipf.de/.*",  # a timeout from time to time
@@ -118,6 +119,7 @@
 linkcheck_anchors = True
 linkcheck_timeout = 5
 linkcheck_retries = 1
+linkcheck_rate_limit_timeout = 10.0
 
 # The suffix of source filenames.
 source_suffix = {

docs/effective-volto/architecture/bootstrap-volto.md

@@ -137,7 +137,7 @@ In case you need production ready deployment, check the training {doc}`/plone-de
 The example above does not persist yet any changes you make through Volto in
 the Plone docker container backend! For this you need to map the /data directory
 in the container properly. Check Docker
-[storage documentation](https://docs.docker.com/storage/) for more information.
+[storage documentation](https://docs.docker.com/engine/storage/) for more information.
 
 As a quick example: if you add
 `--mount type=bind,source="$(pwd)/plone-data",target=/data`

docs/effective-volto/architecture/razzle.md

@@ -19,5 +19,5 @@ It defines the Babel configuration baseline, and allows you to extend it as well
 It has all the modern development tools (HMR, etc) and a plugin system that you can use from your projects.
 
 ```{note}
-While Razzle is stable, it doesn't see a lot of active development. A possible replacement could be [vite.js](https://vitejs.dev/) and there's already a Proof of Concept that integrates it with Volto.
+While Razzle is stable, it doesn't see a lot of active development. A possible replacement could be [vite.js](https://vite.dev/) and there's already a Proof of Concept that integrates it with Volto.
 ```

docs/effective-volto/getting-started/project.md

@@ -37,7 +37,7 @@ Finally, install `yarn` according to the [Plone documentation](https://6.docs.pl
 
 ### Docker (optional, but recommended)
 
-Install `Docker` according to the [official documentation](https://docs.docker.com/get-docker/).
+Install `Docker` according to the [official documentation](https://docs.docker.com/get-started/get-docker/).
 
 Generate a new Plone 6 Project:
 

docs/effective-volto/testing/acceptance.md

@@ -97,7 +97,7 @@ dispatch(
 );
 ```
 
-More information about this: https://www.cypress.io/blog/2018/11/14/testing-redux-store/
+More information about this: https://www.cypress.io/blog/testing-redux-store
 
 #### Volto settings
 

docs/plone-deployment/setup.md

@@ -16,7 +16,7 @@ Ensure a seamless learning experience by preparing your computer with the necess
 ### 1. **Operating System**
 
 - **Linux/macOS:** A recent version is preferred. macOS users should have [Homebrew](https://brew.sh/) installed.
-- **Windows:** Consider using [WSL2 with Ubuntu](https://canonical-ubuntu-wsl.readthedocs-hosted.com/en/latest/), though it’s not officially tested for this training.
+- **Windows:** Consider using [WSL2 with Ubuntu](https://documentation.ubuntu.com/wsl/en/latest/), though it’s not officially tested for this training.
 
 ### 2. **Code Editor**
 
@@ -131,9 +131,9 @@ You can also configure settings for Docker Desktop.
 Under {guilabel}`Prefences > Resources > Advanced`, you can configure appropriate settings for virtual disk limit and memory.
 
 ```{seealso}
-- [Change Docker Desktop settings on Mac](https://docs.docker.com/desktop/settings/mac/#advanced)
-- [Change Docker Desktop settings on Windows](https://docs.docker.com/desktop/settings/windows/#advanced)
-- [Change Docker Desktop settings on Linux](https://docs.docker.com/desktop/settings/linux/#advanced)
+- [Change Docker Desktop settings on Mac](https://docs.docker.com/desktop/settings/#advanced)
+- [Change Docker Desktop settings on Windows](https://docs.docker.com/desktop/settings/#advanced)
+- [Change Docker Desktop settings on Linux](https://docs.docker.com/desktop/settings/#advanced)
 ```
 
 #### Insufficient Docker virtual memory