Merge pull request #327 from raifdmueller/fix/mikado-numbered-list

fix: render numbered list in Mikado Method recipe

Author: rdmueller

docs/anchors/mikado-method.adoc

@@ -43,26 +43,35 @@ Key Proponents:: Ola Ellnestam, Daniel Brolund ("The Mikado Method", 2012)
 [discrete]
 == *Mikado Method Recipe (Canonical Form)*
 
-1. Start here: Draw the Mikado Goal.
-2. Implement the goal or prerequisite naively.
-3. Are there any errors?
-* Examples: compiler errors, failing tests, runtime errors, broken builds.
-* If *Yes*, go to step 4.
-* If *No*, go to step 9.
-4. Come up with immediate solutions to the errors.
-5. Draw the solutions as new prerequisites in the Mikado Graph.
-6. Revert all changes and return to the last known good state.
-7. Select the next prerequisite to work with.
-8. Go to step 2.
-9. Does the change make sense?
-* Examples: understandable, internally consistent, safe to keep, useful on its own.
-* If *Yes*, go to step 10.
-* If *No*, go to step 7.
-10. Commit the change.
-11. Is the Mikado Goal met?
-* If *Yes*, go to step 12.
-* If *No*, go to step 7.
-12. DONE!
+. Start here: Draw the Mikado Goal.
+. Implement the goal or prerequisite naively.
+. Are there any errors?
++
+--
+** Examples: compiler errors, failing tests, runtime errors, broken builds.
+** If *Yes*, go to step 4.
+** If *No*, go to step 9.
+--
+. Come up with immediate solutions to the errors.
+. Draw the solutions as new prerequisites in the Mikado Graph.
+. Revert all changes and return to the last known good state.
+. Select the next prerequisite to work with.
+. Go to step 2.
+. Does the change make sense?
++
+--
+** Examples: understandable, internally consistent, safe to keep, useful on its own.
+** If *Yes*, go to step 10.
+** If *No*, go to step 7.
+--
+. Commit the change.
+. Is the Mikado Goal met?
++
+--
+** If *Yes*, go to step 12.
+** If *No*, go to step 7.
+--
+. DONE!
 
 
 [discrete]

docs/anchors/mikado-method.de.adoc

@@ -43,26 +43,35 @@ Schlüsselvertreter:: Ola Ellnestam, Daniel Brolund ("The Mikado Method", 2012)
 [discrete]
 == *Mikado-Methode-Rezept (kanonische Form)*
 
-1. Hier beginnen: Das Mikado-Ziel aufschreiben.
-2. Das Ziel oder die Voraussetzung naiv implementieren.
-3. Treten Fehler auf?
-* Beispiele: Compilerfehler, fehlschlagende Tests, Laufzeitfehler, kaputte Builds.
-* Wenn *Ja*, gehe zu Schritt 4.
-* Wenn *Nein*, gehe zu Schritt 9.
-4. Unmittelbare Lösungen für die Fehler finden.
-5. Die Lösungen als neue Voraussetzungen in den Mikado-Graphen einzeichnen.
-6. Alle Änderungen rückgängig machen und zum letzten bekannten guten Zustand zurückkehren.
-7. Die nächste zu bearbeitende Voraussetzung auswählen.
-8. Gehe zu Schritt 2.
-9. Ist die Änderung sinnvoll?
-* Beispiele: verständlich, intern konsistent, sicher beizubehalten, für sich allein nützlich.
-* Wenn *Ja*, gehe zu Schritt 10.
-* Wenn *Nein*, gehe zu Schritt 7.
-10. Die Änderung committen.
-11. Ist das Mikado-Ziel erreicht?
-* Wenn *Ja*, gehe zu Schritt 12.
-* Wenn *Nein*, gehe zu Schritt 7.
-12. FERTIG!
+. Hier beginnen: Das Mikado-Ziel aufschreiben.
+. Das Ziel oder die Voraussetzung naiv implementieren.
+. Treten Fehler auf?
++
+--
+** Beispiele: Compilerfehler, fehlschlagende Tests, Laufzeitfehler, kaputte Builds.
+** Wenn *Ja*, gehe zu Schritt 4.
+** Wenn *Nein*, gehe zu Schritt 9.
+--
+. Unmittelbare Lösungen für die Fehler finden.
+. Die Lösungen als neue Voraussetzungen in den Mikado-Graphen einzeichnen.
+. Alle Änderungen rückgängig machen und zum letzten bekannten guten Zustand zurückkehren.
+. Die nächste zu bearbeitende Voraussetzung auswählen.
+. Gehe zu Schritt 2.
+. Ist die Änderung sinnvoll?
++
+--
+** Beispiele: verständlich, intern konsistent, sicher beizubehalten, für sich allein nützlich.
+** Wenn *Ja*, gehe zu Schritt 10.
+** Wenn *Nein*, gehe zu Schritt 7.
+--
+. Die Änderung committen.
+. Ist das Mikado-Ziel erreicht?
++
+--
+** Wenn *Ja*, gehe zu Schritt 12.
+** Wenn *Nein*, gehe zu Schritt 7.
+--
+. FERTIG!
 
 
 [discrete]

website/src/__tests__/adoc-lint.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const anchorsDir = path.join(__dirname, '..', '..', '..', 'docs', 'anchors')
+
+describe('AsciiDoc anchor content validation', () => {
+  it('should not use Markdown-style numbered lists (1. 2. 3.) in .adoc files', () => {
+    const files = fs.readdirSync(anchorsDir).filter((f) => f.endsWith('.adoc'))
+    const violations = []
+
+    for (const file of files) {
+      const content = fs.readFileSync(path.join(anchorsDir, file), 'utf-8')
+      const lines = content.split('\n')
+
+      let inCodeBlock = false
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i]
+        // Track AsciiDoc code blocks (---- or ....)
+        if (/^(-{4,}|\.{4,})$/.test(line.trim())) {
+          inCodeBlock = !inCodeBlock
+          continue
+        }
+        if (inCodeBlock) continue
+        // Match lines starting with "1." "2." etc. (Markdown ordered list)
+        if (/^\d+\.\s/.test(line)) {
+          violations.push(`${file}:${i + 1}: "${line.trim()}"`)
+        }
+      }
+    }
+
+    expect(
+      violations,
+      `Found Markdown-style numbered lists in AsciiDoc files. ` +
+        `Use AsciiDoc ordered list syntax (. item) instead:\n${violations.join('\n')}`
+    ).toEqual([])
+  })
+})