Das Problem
Entwickler schreiben mehr Text als die meisten Menschen merken. Jenseits des Codes selbst gibt es einen konstanten Strom von Non-Code-Writing, das innerhalb VS Code passiert: Inline-Kommentare, Funktion-Docstrings, README-Sektionen, Commit-Message-Entwürfe, Ticket-Beschreibungen, Todo-Annotations und Architektur-Entscheidungs-Notizen.
Dieses Schreiben wird oft als sekundär behandelt — etwas schnell zu tun oder später zu verschieben. Das Ergebnis sind Codebases mit spärlicher Dokumentation, Funktionen ohne Erklärung, warum sie existieren und Architektur-Entscheidungen, die nur in jemandes Gedächtnis existieren.
Die Reibung ist real. Nach dem Aufwenden von mentaler Energie auf einen komplexen Algorithmus, ist das letzte, was die meisten Entwickler tun möchten, einen Absatz schreiben, der ihn erklärt. Tippen fühlt sich wie zusätzliche Arbeit auf der echten Arbeit an. Aber Dokumentation, die sofort nach der Implementierung geschrieben ist — während der Kontext frisch ist — ist dramatisch wertvoller als Dokumentation, die eine Woche später geschrieben ist oder nie.
Wie Telvr mit VS Code funktioniert
Telvr integriert sich mit VS Code und jedem anderen Text-Editor durch System-Level-Cursor-Position-Injection. Keine VS Code-Erweiterung ist erforderlich. Kein API-Schlüssel in deinem Editor. Keine Konfiguration innerhalb VS Code selbst.
Der Workflow für Entwicklungs-Dokumentation:
- Öffne VS Code und positioniere deinen Cursor, wo die Dokumentation erscheinen soll — über einer Funktion, in einem Kommentar-Block, in einer README-Datei oder in einem neuen Markdown-Dokument.
- Drücke dein Telvr-Hotkey.
- Sprich deine Dokumentation, Erklärung oder Task-Beschreibung.
- Lasse das Hotkey los. Die formatierte Ausgabe erscheint an deiner Cursor-Position in unter zwei Sekunden.
- Weitercoden.
Telvr funktioniert in allen VS Code-Kontexten: der Editor selbst, das integrierte Terminal (für gesprochene Befehls-Ideen) und Markdown-Preview-Dateien. Es funktioniert auch in VS Codes Settings-JSON und anderen Konfigurations-Dateien, wo du Kommentare hinzufügen könntest.
Bester Enrichment-Modus für VS Code: Dev Task
Der Modus Dev Task ist speziell für Entwicklungs-Workflow-Dokumentation ausgelegt. Wenn du ihn aktivierst und über ein Stück Code oder eine Task sprichst, strukturiert die AI deine Ausgabe in ein Entwicklungs-fertiges Format mit vier Sektionen um:
Kontext: Background-Information, die erklärt, was dieser Code macht, warum er existiert oder welches Problem er löst.
Anforderungen: Was die Implementierung erfüllen muss — Constraints, Abhängigkeiten, Edge Cases oder Geschäfts-Regeln.
Implementierungs-Notizen: Technische Details, verfolgter Ansatz, betrachtete Trade-offs oder wichtige Vorbehalte.
Akzeptanzbedingungen: Wie man überprüft, dass die Implementierung korrekt ist — welche Tests bestehen sollten, welches Verhalten zu erwarten ist oder welche Bedingungen Erfolg definieren.
Diese Struktur ist sofort nützlich für:
- Funktions-Level-Dokumentations-Blöcke, die komplexe Logik erklären
- Datei-Level-Header-Kommentare für nicht-offensichtliche Module
- Task-Beschreibungen bei der Planung von Arbeit direkt in Code-Dateien
- Architektur-Entscheidungs-Datensätze (ADRs) in Markdown entworfen
Für einfachere Inline-Kommentare — eine schnelle Erklärung eines Regex, eine Notiz über eine bekannte Limitierung — gibt der Modus Bereinigen & Korrigieren dir saubere, lesbare Prosa ohne die formale Struktur.
Vorher-Nachher-Beispiel
Rohspracheingabe (Modus Dev Task):
"also diese Funktion handhabt das Rate-Limiting für die API ähm sie muss Anfragen pro Nutzer pro Minute tracken und sie sollte ein Sliding-Window nutzen nicht ein Fixed-Window weil Fixed-Windows burst Traffic genau an der Grenze erlauben können, richtig ähm sie hängt von Redis für die Counter-Storage ab und sie sollte 429 mit einem Retry-After-Header zurückgeben, wenn das Limit überschritten ist wir sollten auch sicherstellen, dass die Limit-Keys automatisch ablaufen, sodass wir Redis mit der Zeit nicht vollstopfen"
Nach Modus Dev Task:
Kontext Handhabt Pro-Nutzer-API-Rate-Limiting mit einem Sliding-Window-Algorithmus. Nutzt Redis für verteilte Counter-Storage zur Unterstützung von Multi-Instance-Deployments.
Anforderungen
- Anfragen pro Nutzer pro Minute mit Sliding-Window tracken (nicht Fixed-Window)
- HTTP 429 mit
Retry-After-Header zurückgeben, wenn Limit überschritten ist- Redis-Keys müssen automatisch ablaufen, um unbegrenztes Storage-Wachstum zu verhindern
Implementierungs-Notizen
- Sliding-Window wurde über Fixed-Window gewählt, um Burst-Traffic an Fenster-Grenzen zu verhindern
- Redis-Abhängigkeit erforderlich für verteilten Rate-Limit-Status
Akzeptanzbedingungen
- Rate-Limit wird unter anhaltender und Burst-Traffic-Muster korrekt erzwungen
- Redis-Keys laufen wie erwartet ab (überprüfe mit TTL-Befehlen)
- 429-Responses enthalten einen gültigen
Retry-After-Header- Keine Redis-Key-Ansammlung nach ausgedehnten Test-Perioden
Die gesprochene Version ist eine schweifende Erklärung. Die Dev Task-Ausgabe ist eine strukturierte Spezifikation, die du direkt über der Funktion als Dokumentations-Block einfügen kannst.
Zeit-Ersparnis
Dokumentation wird chronisch unterpriorisiert, weil sie langsam ist zu schreiben relativ zu ihrem wahrgenommenen Wert im Moment. Entwickler, die zu Voice-Dokumentation wechseln, berichten zwei Änderungen: sie dokumentieren mehr und sie dokumentieren besser.
Ein gründlicher Funktions-Dokumentations-Block zu schreiben braucht fünf bis acht Minuten fokussierten Tippens. Den gleichen Inhalt zu sprechen braucht sechzig bis neunzig Sekunden und der Modus Dev Task handhabt die Formatierung. Die reduzierte Zeit-Investition macht Dokumentation machbar statt belastend.
Für längere Dokumente — READMEs, Architektur-Entscheidungs-Datensätze, Onboarding-Guides — skaliert die Zeit-Ersparnis proportional. Eine Eintausend-Wort-README, die fünfundvierzig Minuten zu schreiben braucht, kann in zehn bis zwölf Minuten diktiert und dann editiert werden.
Es gibt auch ein Qualitäts-Argument. Wenn Dokumentation sofort nach dem Coden entworfen wird, während Implementierungs-Details frisch sind, ist die resultierende Dokumentation genauer und nützlicher. Telvrs Geschwindigkeit macht es praktisch, während des Codens zu dokumentieren statt als deferred Task.
Über eine typische Entwicklungs-Woche mit regulärer Dokumentations-Arbeit kann Telvr zwei bis drei Stunden wiederhergestellt — und eine bessere-dokumentierte Codebasis als Seiteneffekt produzieren.
Erste Schritte
- Lade Telvr für macOS von telvr.ai herunter.
- Schließe das Setup ab und konfiguriere dein bevorzugtes Mikrofon.
- Stelle ein Hotkey ein, das in deinem VS Code-Workflow funktioniert — etwas, das du drücken kannst, ohne deine Hände weit weg von der Home Row zu bewegen.
- Öffne VS Code, positioniere deinen Cursor über einer Funktion oder in einem Dokumentations-Block und teste dein erstes Diktieren.
- Stelle Dev Task als deinen Standard-Modus für Entwicklungs-Dokumentations-Arbeit ein.
Eine gute erste Übung: finde die drei komplexesten Funktionen in deinem aktuellen Projekt — die, die am meisten von klarer Dokumentation profitieren würden — und diktiere einen Dev Task-Block für jeden. Die ganze Übung sollte unter zehn Minuten brauchen und Dokumentation produzieren, die eine Stunde zu schreiben braucht hätte.
Telvr beinhaltet eine 14-Tage-Testversion mit vollständigem Zugriff auf alle Enrichment-Modi. Nach der Testversion betragen die Preise EUR 3 pro Monat plus ab EUR 0,003 pro Minute Transkription.