Spraakcodering in VS Code: Dicteert commentaar en documentatie

Het probleem

Ontwikkelaars schrijven meer tekst dan de meeste mensen beseffen. Voorbij de code zelf is er een voortdurende stroom non-code schrijven dat plaatsvindt in VS Code: inline opmerkingen, functie docstrings, README secties, commit bericht concepten, ticket beschrijvingen, todo aantekeningen en architectuur besluit notities.

Dit schrijven wordt often als secondair behandeld — iets om snel te doen, of tot later uit te stellen. Het resultaat is codebases met schaarse documentatie, functies zonder uitleg van waarom ze bestaan, en architectuur besluiten die alleen in iemands geheugen bestaan.

De wrijving is reëel. Na het uitgeven van mentale energie op een complex algoritme, is het laatste wat de meeste ontwikkelaars willen doen een alinea schrijven die het uitlegt. Typen voelt als extra werk bovenop het echte werk. Maar documentatie geschreven onmiddellijk na implementatie — terwijl de context vers is — is dramatisch veel waardevol dan documentatie geschreven een week later, of nooit.

Hoe Telvr met VS Code werkt

Telvr integreert met VS Code en elk ander teksteditor via systeemlaag-cursorpositie injectie. Geen VS Code extensie vereist. Geen API sleutel in je editor. Geen configuratie in VS Code zelf.

De workflow voor development documentatie:

1. Open VS Code en plaats je cursor waar je de documentatie wilt — boven een functie, in een commentaarblok, in een README bestand, of in een nieuw markdown document.
2. Druk op je Telvr hotkey.
3. Spreek je documentatie, uitleg of taakbeschrijving.
4. Laat de hotkey los. De opgemaakte output verschijnt op je cursor in minder dan twee seconden.
5. Blijf coderen.

Telvr werkt in alle VS Code contexten: de editor zelf, de geïntegreerde terminal (voor gesproken opdracht ideeën) en markdown preview bestanden. Het werkt ook in VS Code's settings JSON en andere configuratiebestanden waar je opmerkingen wilt toevoegen.

Beste verrijkingsmodus voor VS Code: Dev Task

De Dev Task modus is speciaal ontworpen voor development workflow documentatie. Wanneer je het activeert en spreekt over een stuk code of een taak, structureert de AI je output in een development-klaar format met vier secties:

Context: Achtergrondinformatie die uitlegt wat deze code doet, waarom het bestaat of welk probleem het lost.

Vereisten: Wat de implementatie moet bevredigen — beperkingen, afhankelijkheden, randgevallen of zakelijke regels.

Implementatie notities: Technische details, gevolgde benadering, overwogen trade-offs of belangrijke voorbehouden.

Acceptatie criteria: Hoe verifieer je dat de implementatie juist is — welke testen moeten slagen, wat gedrag verwacht of welke condities succes definiëren.

Deze structuur is onmiddellijk nuttig voor:

• Functie-niveau documentatieblokken die complexe logica uitlegen
• Bestands-niveau koppelingen voor non-duidelijke modules
• Taakbeschrijvingen bij het plannen van werk direct in codebestanden
• Architectuur besluit records (ADRs) concept in markdown

Voor eenvoudiger inline opmerkingen — een snelle uitleg van een regex, een opmerking over een bekende beperking — geeft Clean en Correct modus je schone, leesbare proza zonder de formele structuur.

Voor- en nabeelding

Ruwe spraaksinvoer (Dev Task modus):

"dus deze functie handelt de rate limiting voor de API uh het moet verzoeken per gebruiker per minuut volgen en het moet een sliding window gebruiken geen vaste window omdat vaste windows burst verkeer recht op de grens toestaan um het hangt af van Redis voor de teller opslag en het moet 429 terugsturen met een retry-after header wanneer de limiet wordt overschreden we moeten er ook voor zorgen dat de sleutels automatisch verlopen zodat we Redis niet in de loop der tijd invullen"

Na Dev Task modus:

Context Handelt per-gebruiker API rate limiting af met behulp van sliding window algoritme. Gebruikt Redis voor gedistribueerde teller opslag ter ondersteuning van multi-instance implementaties.

Vereisten

• Volg verzoeken per gebruiker per minuut met sliding window (geen vaste window)
• Geef HTTP 429 terug met Retry-After header wanneer limiet wordt overschreden
• Redis sleutels moeten automatisch verlopen om onbegrensd opslag groei te voorkomen

Implementatie notities

• Sliding window gekozen boven vaste window om burst verkeer op venstergrenzen te voorkomen
• Redis afhankelijkheid vereist voor gedistribueerde rate limit state

Acceptatie criteria

• Rate limit wordt correct afgedwongen onder aanhoudend en burst verkeerspatronen
• Redis sleutels verlopen zoals verwacht (controleer met TTL commando's)
• 429 reacties bevatten geldige Retry-After header
• Geen Redis sleutelophoping na verlengde testperiodes

De gesproken versie is een zwevende uitleg. De Dev Task output is een gestructureerde specificatie die je direct boven de functie als documentatieblok kunt plakken.

Tijdbesparing

Documentatie wordt chronisch onderprioriteit omdat het traag is om te schrijven ten opzichte van zijn waargenomen waarde in het moment. Ontwikkelaars die overschakelen naar spraakdocumentatie rapporteren twee veranderingen: ze documenteren meer, en ze documenteren beter.

Het schrijven van een grondige functiedocumentatie blok duurt vijf tot acht minuten gericht typen. De inhoud spreken duurt zestig tot negentig seconden, en Dev Task modus handelt opmaak af. De verminderde tijd investering maakt documentatie voelen levensvatbaar in plaats van belastend.

Voor langere documenten — READMEs, architectuur besluit records, onboarding gidsen — schalen de tijdbesparingen evenredig. Een duizend-woord README die vijfenveertig minuten zou nemen om te schrijven kan in tien tot twaalf minuten worden gedicteerd en dan bewerkt.

Er is ook een kwaliteit argument. Wanneer documentatie onmiddellijk na het schrijven van de code wordt geschreven, terwijl implementatie details vers zijn, is de resulterende documentatie nauwkeuriger en nuttiger. Telvr's snelheid maakt het praktisch om te documenteren terwijl coderen in plaats van als uitgestelde taak.

Over een typische development week met regelmatig documentatie werk kan Telvr twee tot drie uur terugwinnen — en een betere-gedocumenteerde codebase als neveneffect produceren.

Aan de slag

1. Download Telvr voor macOS van telvr.ai.
2. Voltooi setup en configureer je voorkeur microfoon.
3. Stel een hotkey in die in je VS Code workflow werkt — iets dat je zonder je handen ver van de home row te verplaatsen kunt indrukken.
4. Open VS Code, plaats je cursor boven een functie of in een documentatieblok en test je eerste dictatie.
5. Stel Dev Task in als je standaard modus voor development documentatiewerk.

Een goed eerste oefening: zoek de drie meest complexe functies in je hudig project — de functies die het meest baat hebben bij duidelijke documentatie — en dicteert een Dev Task blok voor elk. De gehele oefening zou minder dan tien minuten in beslag nemen en documentatie produceren die een uur duren zou om te schrijven.

Telvr bevat een 14-daagse gratis proefperiode met volledige toegang tot alle verrijkingsmodi. Na de proefperiode zijn prijzen EUR 3 per maand plus EUR 0,003 per minuut transcriptie.