diff --git a/.markdownlint/fix-renamed-links.js b/.markdownlint/fix-renamed-links.js
index 17336bb086..e48bbe2b1f 100644
--- a/.markdownlint/fix-renamed-links.js
+++ b/.markdownlint/fix-renamed-links.js
@@ -123,6 +123,14 @@ const isRelativeLinkPossible = (link, file) => {
const linkFolder = link.split('/')[1];
const fileFolder = file.split('/')[1];
+ if (linkFolder === 'docs' && fileFolder === 'docs') {
+ if (link.match(/^\/docs\/\d\.\d\//)) {
+ // This is a versioned link.
+ // We don't want to normalise these.
+ return false;
+ }
+ }
+
// In Docusaurus, different root folders contain different plugin instances.
// Docusaurus does not support relative links between different plugins.
return linkFolder === fileFolder;
@@ -164,7 +172,11 @@ const getOptimisedLink = (mappings, file, currentLink, forceRelative) => {
const updatedLink = mappings[normalisedCurrentLink] ? mappings[normalisedCurrentLink] : normalisedCurrentLink;
const relativeLinkPossible = isRelativeLinkPossible(updatedLink, normalisedCurrentFile);
const forceRelativeLink = shouldForceRelativeForLink(currentLink, forceRelative);
+ const isRelativeLink = currentLink.startsWith('./') || currentLink.startsWith('../');
+ if (isRelativeLink && !relativeLinkPossible) {
+ return updatedLink;
+ }
if (updatedLink === normalisedCurrentLink && !forceRelativeLink) {
// There is no rename for this file.
// Configuration is set to _not_ force a relative link for this section.
diff --git a/docs/devupdate.md b/docs/devupdate.md
index bd8fa5e969..44752c8901 100644
--- a/docs/devupdate.md
+++ b/docs/devupdate.md
@@ -595,6 +595,6 @@ Here you can find all the functionality that has been deprecated in PHPUnit 9.x
## Previous versions
-- [Moodle 4.3 developer update](./4.3/devupdate)
-- [Moodle 4.2 developer update](./4.2/devupdate)
-- [Moodle 4.1&4.0 developer update](./4.1/devupdate)
+- [Moodle 4.3 developer update](/docs/4.3/devupdate)
+- [Moodle 4.2 developer update](/docs/4.2/devupdate)
+- [Moodle 4.1&4.0 developer update](/docs/4.1/devupdate)
diff --git a/docs/guides/bs5migration/index.md b/docs/guides/bs5migration/index.md
index f050def669..3b769c786d 100644
--- a/docs/guides/bs5migration/index.md
+++ b/docs/guides/bs5migration/index.md
@@ -23,7 +23,7 @@ See more about Bootstrap 5 breaking changes in the [official documentation](http
To achieve a smoother process and facilitate the moment of the update, the migration has been divided into different steps:
1. **PopperJS upgrade**: This is the first step in the migration process, as Bootstrap 5 requires PopperJS version 2. This step is about upgrading the current PopperJS version to version 2. Because we still need PopperJS version 1 for Bootstrap 4 both versions will co-exist until all usages are migrated to v2.
-2. **SCSS Deprecation process**: A SCSS deprecation process will be needed for the cleanup after BS5 upgrade. More details about it in [SCSS deprecation](../../general/development/policies/deprecation/scss-deprecation).
+2. **SCSS Deprecation process**: A SCSS deprecation process will be needed for the cleanup after BS5 upgrade. More details about it in [SCSS deprecation](/general/development/policies/deprecation/scss-deprecation).
3. **Refactoring BS4 features dropped in BS5**: This step is about refactoring the current Bootstrap 4 features that will be deprecated or dropped in its version 5 and they can be replaced with current codebase.
4. **Create a BS5 "bridge"**: Some simple breaking changes could be also addressed in advance creating a BS5 "bridge". With small additions to this "bridge", we can refactor in advance the occurrences in the codebase for some dropped features in BS5.
5. **BS5 upgrade**: Upgrade the current Bootstrap 4 version to version 5.
diff --git a/general/development/tracker/labels.md b/general/development/tracker/labels.md
index 82dde45429..e52d19cdb3 100644
--- a/general/development/tracker/labels.md
+++ b/general/development/tracker/labels.md
@@ -91,7 +91,7 @@ Used to identify all issues to be listed in the release notes (minor or major).
Issues that need to be mentioned in the user documentation [under 'Possible issues that may affect you in Moodle X.0' (major versions).
- [`developer_notes`](https://tracker.moodle.org/issues/?jql=labels%20%3D%20developer_notes)
-Issues that need to be mentioned in the [integration exposed forum](https://moodle.org/mod/forum/view.php?f=1153) and in the [Moodle developer update documentation](../../../docs/devupdate).
+Issues that need to be mentioned in the [integration exposed forum](https://moodle.org/mod/forum/view.php?f=1153) and in the [Moodle developer update documentation](/docs/devupdate).
- `lost_functionality`
Used to identify issues describing functionality which was available in an earlier version but which is no longer available in the latest version.