diff --git a/markdown/docs/migration/index.md b/markdown/docs/migration/index.md
index 195bcc35cf54..a8a57359ae21 100644
--- a/markdown/docs/migration/index.md
+++ b/markdown/docs/migration/index.md
@@ -1,5 +1,6 @@
 ---
 title: "Overview"
+weight: 1
 ---
 Migration to a new major version is always difficult, and AsyncAPI is no exception, but we want to provide as smooth a transition as possible.
 
diff --git a/markdown/docs/migration/migrating-to-v3.md b/markdown/docs/migration/migrating-to-v3.md
index 85fa6bb47a76..00587645fee6 100644
--- a/markdown/docs/migration/migrating-to-v3.md
+++ b/markdown/docs/migration/migrating-to-v3.md
@@ -1,5 +1,6 @@
 ---
 title: "Migrating to v3"
+weight: 2
 ---
 
 
diff --git a/scripts/markdown/check-markdown.js b/scripts/markdown/check-markdown.js
index 77150477ab64..8979f7e0b4ab 100644
--- a/scripts/markdown/check-markdown.js
+++ b/scripts/markdown/check-markdown.js
@@ -109,6 +109,11 @@ function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
             const filePath = path.join(folderPath, file);
             const relativeFilePath = path.join(relativePath, file);
 
+            // Skip the folder 'docs/reference/specification'
+            if (relativeFilePath.includes('reference/specification')) {
+                return;
+            }
+
             fs.stat(filePath, (err, stats) => {
                 if (err) {
                     console.error('Error reading file stats:', err);