fix: enhance Mikado Method documentation with canonical form links and consistency fixes

Author: Jörg Thönnes

docs/anchors/mikado-method.adoc

@@ -39,28 +39,29 @@ Key Proponents:: Ola Ellnestam, Daniel Brolund ("The Mikado Method", 2012)
 * Making incremental improvements without blocking the team
 * Brownfield development with hidden dependencies
 
+[[mikado-method-recipe-canonical-form]]
 [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.
+* 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.
+* 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.
+* If *Yes*, go to step 12.
+* If *No*, go to step 7.
 12. DONE!
 
 

docs/anchors/mikado-method.de.adoc

@@ -16,7 +16,7 @@ Mikado-Ziel:: Der klare, angestrebte zukünftige Zustand des Codes nach dem Refa
 
 Voraussetzungsermittlung:: Blockierende Abhängigkeiten aufdecken, indem die Änderung versucht und notiert wird, was dabei bricht
 
-Experimente nutzen:: Bevorzuge schnelle oder zeitlich begrenzte empirische Versuche gegenüber langen Vorabananalysen
+Experimente nutzen:: Bevorzuge schnelle oder zeitlich begrenzte empirische Versuche gegenüber langen Vorab-Analysen
 
 Immer rückgängig machen:: *WICHTIG*: Nach dem Entdecken einer Voraussetzung *immer* zum letzten bekannten funktionierenden Zustand zurückkehren, bevor diese angegangen wird
 
@@ -39,28 +39,29 @@ Schlüsselvertreter:: Ola Ellnestam, Daniel Brolund ("The Mikado Method", 2012)
 * Inkrementelle Verbesserungen vornehmen, ohne das Team zu blockieren
 * Brownfield-Entwicklung mit versteckten Abhängigkeiten
 
+[[mikado-methode-rezept-kanonische-form]]
 [discrete]
-== *Mikado-Methode Rezept (Kanonische Form)*
+== *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.
+* 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.
+* 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.
+* Wenn *Ja*, gehe zu Schritt 12.
+* Wenn *Nein*, gehe zu Schritt 7.
 12. FERTIG!