Merge pull request #3270 from AndreMiras/feature/documentation

📝 Fix documentation linkcheck failures

Author: AndreMiras

doc/source/apis.rst

@@ -140,7 +140,7 @@ With Kivy, add an ``on_pause`` method to your App class, which returns True::
 
 With the webview bootstrap, pausing should work automatically.
 
-Under SDL2, you can handle the `appropriate events <https://wiki.libsdl.org/SDL_EventType>`__ (see SDL_APP_WILLENTERBACKGROUND etc.).
+Under SDL2, you can handle the `appropriate events <https://wiki.libsdl.org/SDL3/SDL_EventType>`__ (see SDL_APP_WILLENTERBACKGROUND etc.).
 
 
 Observing Activity result

doc/source/conf.py

@@ -321,3 +321,15 @@ def get_version():
     r"https://github.com/kivy/python-for-android/blob.*",
     ]
 
+# Allow redirects for URLs where we prefer to keep the original form
+linkcheck_allowed_redirects = {
+    # Kivy chat redirects to Discord invite
+    r"https://chat\.kivy\.org/": r"https://discord\.com/.*",
+    # GitHub archive URLs redirect to codeload
+    r"https://github\.com/kivy/python-for-android/archive/.*": r"https://codeload\.github\.com/.*",
+    # GitHub gist homepage redirects to starred
+    r"https://gist\.github\.com/$": r"https://gist\.github\.com/.*",
+    # Google Play Store redirects
+    r"https://play\.google\.com/store/$": r"https://play\.google\.com/store/.*",
+}
+

doc/source/index.rst

@@ -18,7 +18,7 @@ It can generate:
 
 It supports multiple CPU architectures.
 
-It supports apps developed with `Kivy framework <http://kivy.org>`_, but was
+It supports apps developed with `Kivy framework <https://kivy.org/>`_, but was
 built to be flexible about the backend libraries (through "bootstraps"), and
 also supports `PySDL2 <https://pypi.org/project/PySDL2/>`_, and a
 `WebView <https://developer.android.com/reference/android/webkit/WebView>`_ with
@@ -34,7 +34,7 @@ dependencies for Android devices, and bundling it with the app's python code
 and dependencies. The Python code is then interpreted on the Android device.
 
 It is recommended that python-for-android be used via
-`Buildozer <https://buildozer.readthedocs.io/>`_, which ensures the correct
+`Buildozer <https://buildozer.readthedocs.io/en/latest/>`_, which ensures the correct
 dependencies are pre-installed, and centralizes the configuration. However,
 python-for-android is not limited to being used with Buildozer.