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.