chore: migrate to block renderization approach

Author: UlisesGascon

scripts/populate-details.js

@@ -54,27 +54,34 @@ const renderDetails = (check) => {
 
 // Prepare the markdown files
 checks.forEach((check, index) => {
-  const fileContent = `---
+  const metadata = `---
 sidebar_position: ${index + 1}
 id: ${check.id}
 title: ${check.title}
 slug: /details/${check.code_name}
----
-
-## Use Case
-<!-- LEVELS:START -->
+---`.trim()
+  const levelsContent = `
 - Incubating: ${check.level_incubating_status}
 - Active: ${check.level_active_status}
 - Retiring: ${check.level_retiring_status}
+`.trim()
+  const descriptionContent = `## Description
+${check.description}`.trim()
+  const detailsContent = renderDetails(check)
+
+  const fileContent = `${metadata}
+
+## Use Case
+<!-- LEVELS:START -->
+${levelsContent}
 <!-- LEVELS:END -->
 
 <!-- DESCRIPTION:START -->
-## Description
-${check.description}
+${descriptionContent}
 <!-- DESCRIPTION:END -->
 
 <!-- DETAILS:START -->
-${renderDetails(check)}
+${detailsContent}
 <!-- DETAILS:END -->
 `
   const detination = path.join(process.cwd(), `docs/details/${check.code_name}.mdx`)

scripts/populate-implementations.js

@@ -39,27 +39,29 @@ const addRow = (item) => `| ${item.section_number}. ${capitalizeWords(item.secti
 
 // Prepare the markdown files
 projectStatus.forEach((status, index) => {
-  let fileContent = `---
+  const metadata = `---
 sidebar_position: ${index + 1}
 id: ${status}
 title: ${status.charAt(0).toUpperCase() + status.slice(1)}
 slug: /implementations/${status}
----
-
-<!-- LIST:START -->
-`
-
-  fileContent += implementationPriority.map(priority => {
+---`.trim()
+  const listContent = implementationPriority.map(priority => {
     if (data[status][priority].length === 0) return ''
 
     return `
 ## ${priority.charAt(0).toUpperCase() + priority.slice(1)}
 ${addHeader()}
 ${data[status][priority].map(addRow).join('\n')}
-    `
+  `
   }).join('\n')
 
-  fileContent += '\n<!-- LIST:END -->'
+  const fileContent = `${metadata}
+<!-- LIST:START -->
+
+<!-- LIST:END -->
+${listContent}
+<!-- LIST:END -->
+`
 
   const destination = path.join(process.cwd(), `docs/implementation/${status}.mdx`)
   writeFileSync(destination, fileContent)