Skip to content

docs: link Johannes Rabauer's session summary blog post #465

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
raifdmueller wants to merge 1 commit into
base: main
Choose a base branch
from
+6 −2
Open

docs: link Johannes Rabauer's session summary blog post #465

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs/about.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,8 @@
</span>
</button>
<figcaption>
Two-hour live coding session with Johannes Rabauer and Ralf D. Müller (May 2026)
Two-hour live coding session with Johannes Rabauer and Ralf D. Müller (May 2026).
Read Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/" target="_blank" rel="noopener noreferrer">session summary on rabauer.dev</a>.
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot May 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Sprachhinweis für den verlinkten Beitrag ergänzen.

Auf einer englischen Seite führt der Link auf eine deutsche URL (/de/...), ohne Hinweis auf die Sprache. Das kann Nutzer überraschen. Ein kurzer Hinweis wie „(German)“ im Linktext würde das klar machen.

✏️ Vorschlag 
-    Read Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/" target="_blank" rel="noopener noreferrer">session summary on rabauer.dev</a>.
+    Read Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/" target="_blank" rel="noopener noreferrer">German session summary on rabauer.dev</a>.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Read Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/" target="_blank" rel="noopener noreferrer">session summary on rabauer.dev</a>.
Read Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/" target="_blank" rel="noopener noreferrer">German session summary on rabauer.dev</a>.
🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/about.adoc` at line 33, Die Linkbeschreibung in der Zeile mit dem Anchor
"Read Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/"
...>session summary on rabauer.dev</a>" muss einen Sprachhinweis bekommen;
ändere den sichtbaren Linktext so, dass er z. B. "session summary on rabauer.dev
(German)" lautet, damit Nutzer erkennen, dass die verlinkte Seite auf Deutsch
ist, ohne die href, target oder rel-Attribute zu verändern.

</figcaption>
</figure>
++++
Expand Down
3 changes: 2 additions & 1 deletion docs/about.de.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,8 @@
</span>
</button>
<figcaption>
Zweistündiges Live-Coding mit Johannes Rabauer und Ralf D. Müller (Mai 2026)
Zweistündiges Live-Coding mit Johannes Rabauer und Ralf D. Müller (Mai 2026).
Lies Johannes' <a href="https://rabauer.dev/de/blog/semantic-anchors/" target="_blank" rel="noopener noreferrer">Zusammenfassung auf rabauer.dev</a>.
</figcaption>
</figure>
++++
Expand Down
1 change: 1 addition & 0 deletions docs/spec-driven-workflow.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -620,3 +620,4 @@ See link:#/brownfield[Adapting the Workflow to Brownfield Projects] for a step-b
* Birgitta Böckeler, https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html[Exploring Gen AI] (martinfowler.com) -- a critical analysis of spec-driven development tools (Kiro, spec-kit, Tessl) and their trade-offs. Examines where elaborate upfront specifications help and where they create overhead.
* Simon Martinelli, https://unifiedprocess.ai/[AI Unified Process] -- a requirements-driven methodology combining Rational Unified Process principles with AI tooling. Treats AI as a consistency engine that regenerates code from evolving specifications, with four phases: Inception, Elaboration, Construction, Transition.
* Ralf D. Müller & Simon Martinelli, https://software-architektur.tv/2026/01/16/folge298.html[Spec-Driven Development] (software-architektur.tv, Episode 298) -- podcast discussion on how specifications and requirements take center stage in AI-assisted development, and why iterative refinement beats perfect upfront specs.
* Johannes Rabauer, https://rabauer.dev/de/blog/semantic-anchors/[LLM Coding mit Semantic Anchors: Von Vibe Coding zur echten Java-App] (rabauer.dev, May 2026) -- session summary from a two-hour live coding session walking through the full workflow on a model railway train scheduler. Demonstrates how Semantic Contracts solve context persistence across sessions and how Docs-as-Code practice pays dividends for LLM context.
1 change: 1 addition & 0 deletions docs/spec-driven-workflow.de.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -637,3 +637,4 @@ Siehe link:#/brownfield[Workflow-Anpassung für Brownfield-Projekte] für eine S
* Birgitta Böckeler, https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html[Exploring Gen AI] (martinfowler.com) -- eine kritische Analyse von Spec-Driven-Development-Tools (Kiro, spec-kit, Tessl) und deren Trade-offs. Untersucht, wo aufwändige Upfront-Spezifikationen helfen und wo sie Overhead erzeugen.
* Simon Martinelli, https://unifiedprocess.ai/[AI Unified Process] -- eine anforderungsgetriebene Methodik, die Rational-Unified-Process-Prinzipien mit KI-Tooling kombiniert. Behandelt KI als Konsistenz-Engine, die Code aus sich entwickelnden Spezifikationen regeneriert, in vier Phasen: Inception, Elaboration, Construction, Transition.
* Ralf D. Müller & Simon Martinelli, https://software-architektur.tv/2026/01/16/folge298.html[Spec-Driven Development] (software-architektur.tv, Folge 298) -- Podcast-Diskussion darüber, wie Spezifikationen und Anforderungen in den Mittelpunkt KI-gestützter Entwicklung rücken, und warum iterative Verfeinerung besser funktioniert als perfekte Upfront-Specs.
* Johannes Rabauer, https://rabauer.dev/de/blog/semantic-anchors/[LLM Coding mit Semantic Anchors: Von Vibe Coding zur echten Java-App] (rabauer.dev, Mai 2026) -- Zusammenfassung einer zweistündigen Live-Coding-Session, die den vollständigen Workflow am Beispiel eines Fahrplans für Modelleisenbahnen durchspielt. Zeigt, wie Semantic Contracts das Problem der Kontext-Persistenz über Sessions hinweg lösen und warum Docs-as-Code-Praxis jetzt für LLM-Kontext doppelt zahlt.
Loading