Blog

Guía Completa de Codificación por Voz: Comentarios, Docs, Tareas, Todo

La documentación de código es el trabajo que la mayoría de desarrolladores pospone. Y el trabajo que se pospone nunca se hace bien. Telvr elimina la fricción y hace que documentar sea tan fácil como hablar.

Casos de Uso Principales

Comentarios de Función

Completa una función compleja. Posiciona el cursor arriba. Presiona hotkey. Habla una explicación. Listo.

Tiempo: 30 segundos de habla vs 2 minutos de escritura.

Mensajes de Commit

En lugar de pensar en mensajes de commit terse, habla lo que hiciste. El modo Limpio y Correcto lo estructura en un mensaje legible.

Descripciones de Tarea

Realiza que un refactoring es necesario. Habla la descripción completa con contexto, requisitos, criterios de aceptación. El modo Dev Task lo estructura.

Docstrings

Docstrings largos para funciones complejas. Habla la documentación de función una vez que está completa. El resultado: documentación clara sin fricción de tipeo.

Mejores Modos

Raw: Para cuando necesitas preservar estructura exacta Clean and Correct: Para comentarios y explicaciones naturales Dev Task: Para tareas y tickets que necesitan estructura

Ejemplo: Refactoring

Estás refactorizando un componente complejo.

Habla (60 segundos): "This component previously mixed layout logic with state management. I've separated concerns by moving state handling to a custom hook. The component now just handles rendering. Benefits: easier to test, easier to reuse the hook elsewhere, clearer separation of concerns. Tests updated to cover both hook and component independently. No breaking changes to the public API."

Dev Task output:

Context: Component refactoring to improve testability and reusability

Requirements:

  • Separate state management into custom hook
  • Component handles rendering only
  • Update all tests
  • No breaking changes to public API

Acceptance Criteria:

  • Hook is independently testable
  • Component tests pass
  • API compatible with previous version

Workflow Tips

  • Set a hotkey you can reach with one hand
  • Keep your IDE window in focus
  • Dictate after code is working, not during
  • Use "Clean and Correct" for most docs
  • Use "Raw" if structure matters exactly

Documentación sin distracción = código mejor documentado.