From f2fe72b986c73ad957fee968f23e000d49fd10c8 Mon Sep 17 00:00:00 2001
From: Yurii Motov <yurii.motov.monte@gmail.com>
Date: Mon, 18 May 2026 18:50:23 +0200
Subject: [PATCH] Revert comment removal in `mkdocs.yml`

---
 docs/en/mkdocs.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/mkdocs.yml b/docs/en/mkdocs.yml
index 1b872271ba..fe873705ec 100644
--- a/docs/en/mkdocs.yml
+++ b/docs/en/mkdocs.yml
@@ -290,7 +290,10 @@ markdown_extensions:
       format: !!python/name:pymdownx.superfences.fence_code_format ''
   pymdownx.tilde: null
   pymdownx.blocks.admonition:
+    # TODO: remove types section (with custom types) once translations are migrated to
+    # not use custom types too
     types:
+    # Default types
     - note
     - attention
     - caution
@@ -299,6 +302,7 @@ markdown_extensions:
     - tip
     - hint
     - warning
+    # Custom types
     - info
     - check
   pymdownx.blocks.details: null