Skip to content

Commit 120f5b3

Browse files
raifdmuellerclaude
andcommitted
fix: use single passthrough block for ADR admonition
Previous implementation with separate +++ blocks for opening/closing div caused AsciiDoc to render empty divs. Changed to single ++++ block containing complete HTML markup. Result: Properly rendered admonition box with all content inside, no empty stripes before/after. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 890f628 commit 120f5b3

1 file changed

Lines changed: 16 additions & 22 deletions

File tree

src/i18n.js

Lines changed: 16 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -333,17 +333,14 @@ Dieses Framework bietet eine https://github.com/LLM-Coding/Semantic-Anchors?tab=
333333
334334
*/risk-mitigate* — Liest die Risikobewertung aus \`CLAUDE.md\`, erkennt bereits vorhandene Maßnahmen (Linter, CI, SAST etc.) und hilft fehlende Mitigations Schritt für Schritt umzusetzen — von Tool-Installation bis CI-Konfiguration.
335335
336-
+++<div class="adr-admonition">+++
337-
338-
*⚠️ Risk-Assessments sind Architekturentscheidungen*
339-
340-
Tier-Klassifizierungen und Mitigation-Strategien sollten als https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions[Architecture Decision Records (ADR nach Nygard)] dokumentiert werden.
341-
342-
\`/risk-assess\` bietet automatische ADR-Generierung an (optional). Der ADR wird in \`docs/adr/\` gespeichert und — falls vorhanden — in arc42 Kapitel 9 referenziert. \`/risk-mitigate\` aktualisiert den ADR mit dem Umsetzungsstatus der Maßnahmen.
343-
344-
*Warum ADRs?* Transparenz (warum wurde Tier X gewählt?), Nachvollziehbarkeit (wer hat wann entschieden?), Reviewbarkeit (Team kann vor Umsetzung diskutieren).
345-
346-
+++</div>+++
336+
++++
337+
<div class="adr-admonition">
338+
<p><strong>⚠️ Risk-Assessments sind Architekturentscheidungen</strong></p>
339+
<p>Tier-Klassifizierungen und Mitigation-Strategien sollten als <a href="https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions" target="_blank" rel="noopener">Architecture Decision Records (ADR nach Nygard)</a> dokumentiert werden.</p>
340+
<p><code>/risk-assess</code> bietet automatische ADR-Generierung an (optional). Der ADR wird in <code>docs/adr/</code> gespeichert und — falls vorhanden — in arc42 Kapitel 9 referenziert. <code>/risk-mitigate</code> aktualisiert den ADR mit dem Umsetzungsstatus der Maßnahmen.</p>
341+
<p><strong>Warum ADRs?</strong> Transparenz (warum wurde Tier X gewählt?), Nachvollziehbarkeit (wer hat wann entschieden?), Reviewbarkeit (Team kann vor Umsetzung diskutieren).</p>
342+
</div>
343+
++++
347344
348345
*Installation — Plugin (empfohlen):*
349346
@@ -696,17 +693,14 @@ This framework provides a https://github.com/LLM-Coding/Semantic-Anchors?tab=rea
696693
697694
*/risk-mitigate* — Reads the risk assessment from \`CLAUDE.md\`, detects already-present measures (linter, CI, SAST, etc.), and helps implement missing mitigations step by step — from tool installation to CI configuration.
698695
699-
+++<div class="adr-admonition">+++
700-
701-
*⚠️ Risk Assessments are Architectural Decisions*
702-
703-
Tier classifications and mitigation strategies should be documented as https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions[Architecture Decision Records (ADR nach Nygard)].
704-
705-
\`/risk-assess\` offers automatic ADR generation (optional). The ADR is saved to \`docs/adr/\` and — if present — referenced in arc42 chapter 9. \`/risk-mitigate\` updates the ADR with mitigation implementation status.
706-
707-
*Why ADRs?* Transparency (why was Tier X chosen?), traceability (who decided when?), reviewability (team can discuss before implementation).
708-
709-
+++</div>+++
696+
++++
697+
<div class="adr-admonition">
698+
<p><strong>⚠️ Risk Assessments are Architectural Decisions</strong></p>
699+
<p>Tier classifications and mitigation strategies should be documented as <a href="https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions" target="_blank" rel="noopener">Architecture Decision Records (ADR nach Nygard)</a>.</p>
700+
<p><code>/risk-assess</code> offers automatic ADR generation (optional). The ADR is saved to <code>docs/adr/</code> and — if present — referenced in arc42 chapter 9. <code>/risk-mitigate</code> updates the ADR with mitigation implementation status.</p>
701+
<p><strong>Why ADRs?</strong> Transparency (why was Tier X chosen?), traceability (who decided when?), reviewability (team can discuss before implementation).</p>
702+
</div>
703+
++++
710704
711705
*Installation — Plugin (recommended):*
712706

0 commit comments

Comments
 (0)