From c9a1d278d8d69cf87e6ddd2bb3242e319c12c369 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mikel=20Mart=C3=ADn?= <mikel@moodle.com>
Date: Thu, 4 Jan 2024 18:16:05 +0100
Subject: [PATCH] [docs] Devdocs Bootstrap forms refactor

---
 docs/devupdate.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/docs/devupdate.md b/docs/devupdate.md
index d282922ab3..56632cac28 100644
--- a/docs/devupdate.md
+++ b/docs/devupdate.md
@@ -40,6 +40,39 @@ will only update the second enrol instance.
 
 A new method `enrol_plugin:find_instance()` is added to the enrol plugin interface to allow plugins to find an existing instance of the same type in the course. If you want your enrolment method to be supported in CSV course upload, you need to implement this [method](./apis/plugintypes/enrol#enrol_pluginfind_instance-stdclass)
 
+## Bootstrap preparations for version 5
+
+<Since version="4.4" issueNumber="MDL-71979" />
+
+Some of the Bootstrap 4 classes will be deprecated or dropped in its version 5. To prepare for this, some of the current Bootstrap 4 classes usages have been replaced with version 5 compatible classes. This will help us to upgrade to Bootstrap 5 in the future.
+
+- The `.form-group` helper class has been replaced with margins.
+- The `.form-inline` helper class has been replaced with utility classes.
+
+:::info Form refactor example
+
+The following code:
+
+```html
+<form class="form-inline">
+    <div class="form-group">
+        [...]
+    </div>
+</form>
+```
+
+could be replaced with:
+
+```html
+<form class="d-flex flex-wrap align-items-center">
+    <div class="mb-3">
+        [...]
+    </div>
+</form>
+```
+
+:::
+
 ## Previous versions
 
 - [Moodle 4.3 developer update](./4.3/devupdate)