polyshCalculadora de tiempo de lectura de documentación
Obtén un tiempo de lectura realista para documentación con código y capturas.
- Funciona en tu navegador
- Sin subidas
- Sin cuenta
Esta herramienta analiza texto en inglés.
Cargando tu herramienta del navegador…
Qué hace Calculadora de tiempo de lectura de documentación
Una guía para desarrolladores con tres ejemplos de código y cuatro capturas de pantalla tarda más en leerse de lo que indica su número de palabras. Pega aquí una página Markdown y la estimación suma tres partes: el texto a 200 palabras por minuto, 3 segundos por cada línea de código y 12 segundos por cada imagen.
Los recuadros muestran cada parte por separado, para que veas si el tiempo está en la explicación o en un ejemplo de configuración largo. El código de los bloques delimitados y con sangría se cuenta por líneas, no por palabras. Cuentan las imágenes de Markdown y las etiquetas img de HTML. Cambia los tiempos de código e imágenes en “Más opciones”. Para artículos sin código, basta con la Calculadora de tiempo de lectura.
Ejemplo
Entrada
## Install the CLI Run the installer, then sign in with your workspace token. The command prints your workspace name when it works. ```bash npm install -g example-cli example login example whoami ``` 
Resultado
Reading time: 0:29 (about 1 minute) Prose: 0:08 (26 words at 200 wpm) Code: 0:09 (3 lines) Images: 0:12 (1 image)
El código y la captura de pantalla suponen más de dos tercios del tiempo de lectura, aunque el texto solo tiene 26 palabras.
Cómo usar Calculadora de tiempo de lectura de documentación
- Pega la página Markdown, o usa “Abrir archivo” con un archivo .md.
- Elige un ritmo de lectura y abre “Más opciones” para ajustar “Tiempo por línea de código” y “Tiempo por imagen”.
- Lee el recuadro “Tiempo de lectura” y el desglose de “Texto”, “Código” e “Imágenes”.
Conviene saber
- Las líneas en blanco dentro de los bloques de código no cuentan, pero el resto de líneas cuentan igual, ya sea un comando de una palabra o una línea de configuración larga.
- Las imágenes solo se cuentan a partir de la sintaxis de imagen de Markdown y de las etiquetas img. Los videos insertados, los diagramas en iframes y las tablas no añaden tiempo extra.
- El código en línea dentro de las frases cuenta como palabras de texto, no como líneas de código.
Preguntas sobre Calculadora de tiempo de lectura de documentación
¿Cuánto debería tardarse en leer una página de documentación?
La mayoría de las páginas de tareas funcionan mejor con 2 a 5 minutos. Quien lee suele llegar para terminar una tarea, así que una página de 10 minutos o más a menudo cubre varias tareas y es más fácil de usar dividida en páginas separadas enlazadas entre sí.
¿Debo mostrar el tiempo de lectura en las páginas de documentación?
Ayuda en tutoriales y guías largas, donde quien lee quiere saber si tiene tiempo de terminar. En páginas de referencia cortas solo añade ruido. Si lo muestras, usa una estimación que incluya el código y las imágenes, porque las palabras solas se quedan cortas en las páginas técnicas.
¿Cuánto se tarda en leer código?
Mucho más por palabra que el texto, porque quien lee revisa la sintaxis y piensa qué hace cada línea. Unos pocos segundos por línea es una media razonable para código conocido. Sube el tiempo por línea para ejemplos complejos o para quien no conoce el lenguaje.