El Problema
VS Code es donde los desarrolladores pasan la mayoría de su tiempo. Pero documentar código — agregando comentarios explicativos, escribiendo docstrings, describiendo tareas en archivos de configuración — requiere cambio de contexto de la programación a la escritura.
Especialmente para cambios complejos, los buenos comentarios son criticos. Pero el tiempo de contexto para escribir un comentario bien pensado toma más tiempo de lo que la mayoría de desarrolladores invierte. El resultado es código con comentarios insuficientes porque simplemente no vale la pena el cambio de contexto para agregarlo manualmente.
Cómo Telvr Funciona con VS Code
Telvr funciona con VS Code a través de inserción de texto a nivel del sistema. No se requiere extensión o integración especial. Posiciona tu cursor, presiona el hotkey, habla, y el texto se inserta en tu editor.
Uso típico:
- Estás escribiendo código y terminas una función compleja
- Posiciona el cursor encima de la función
- Presiona tu hotkey de Telvr
- Habla un comentario o bloque de documentación
- El texto se inserta automáticamente con formato limpio
- Continúa codificando sin salir del editor
Mejores Modos de Enriquecimiento
Clean and Correct: Para comentarios en línea y explicaciones. Remueve muletillas de habla, mantiene un tono claro y conciso.
Dev Task: Si tienes un archivo de tareas o estás describiendo trabajo pendiente. El modo transforma habla bruta en estructura de tarea clara.
Raw: Si necesitas preservar tu estructura de comentario exactamente como la dictaste.
Ejemplo:
Habla bruta:
"okay so uh this recursion handles the tree traversal um we iterate through each node and uh if it has children we recursively process those uh it's depth-first search so we explore each branch fully before moving to the next one"
Después de Clean and Correct:
Recursively traverses the tree using depth-first search. Iterates through each node and processes children before moving to the next branch.
Ahorros de Tiempo
Desarrolladores típicamente escriben diez a veinte comentarios por día. Si cada comentario toma dos minutos de escribir versus treinta segundos de hablar, eso es quince a treinta minutos recuperados al día. Pero más importante, los comentarios hablados frecuentemente son más descriptivos porque hablar es más rápido que escribir, así que obtienes mejor documentación de código como beneficio adicional.
Empezando
- Instala Telvr desde telvr.ai
- Abre VS Code y configura tu hotkey de Telvr
- Posiciona el cursor donde quieres un comentario
- Presiona el hotkey de Telvr
- Habla tu comentario
- El texto se inserta automáticamente
Prueba la versión gratuita de 14 días. Después, EUR 3 mínimo mensual (se descuenta del uso) más desde EUR 0,003 por minuto de audio — bajo una semana de trabajo típica.