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.