Cómo escribir un tutorial

Max Ferzzola . Vista 25389 veces
Cómo escribir un tutorial

Puede parecer simple. Tú sabes que lo sabes y crees que con saberlo debería bastar. Pero hasta el más genio de los genios puede encontrarse ante la imposibilidad de trasmitir sus conocimientos. ¡Les pasa a los mejores, no te preocupes! Es que un tutorial se debe escribir para un lector con escasos conocimientos y, por lo tanto, responde a una dinámica de escritura muy pormenorizada, que debe seguir una estructura lineal, clara y concisa. ¿Necesitas un tutorial de cómo escribir tutoriales? Aquí tienes uno.


  • Un tutorial es como un capítulo de un manual. Enseña una sola cosa. Tutoriales interconectados forman un curso y/o manual. Un tutorial es como un capítulo de un manual. Enseña una sola cosa. Tutoriales interconectados forman un curso y/o manual.

    ¿Qué es un tutorial?
    Antes de comenzar, es necesario aclarar el punto más importante de todo este artículo. Si no sabemos lo que hacemos, no sabemos hacerlo. Por eso, es imprescindible saber qué es y qué no es un tutorial. Veamos.

    Un tutorial es una serie de instrucciones conectadas, una guía paso a paso, que busca enseñar una, y solo una, tarea. Debe tener todo lo necesario para que el objetivo se pueda completar con éxito y el usuario llegue al final con una solución a su problema, inquietud o necesidad.

    Es importante notar que un tutorial no es un manual (o curso). Un manual enseña el uso general de un programa, no una acción específica dentro del mismo. Por ejemplo, en este tutorial enseñamos cómo utilizar Photoshop para remover imperfecciones de la piel. No es un manual sobre Photoshop, sino de una de las tantas cosas que se pueden hacer con él. Lo mismo sucede con este tutorial. Guía a los usuarios a armar un medidor de tensión, no enseña electrónica en general.

    Para que se entienda mejor: los manuales o cursos son una serie de tutoriales conectados que pasean al usuario por todos los aspectos de un programa u oficio, para que aprenda mediante la práctica. ¿Lo quieres más claro todavía? Esto es un tutorial. Esta es la primera parte de un curso.
     

    Piénsalo. ¿Para que gastar tiempo en algo que cuenta con aplicaciones que lo hacen automaticamente? Piénsalo. ¿Para que gastar tiempo en algo que cuenta con aplicaciones que lo hacen automaticamente?

    La preproducción

    1) ¿Hace falta?

    Antes de escribir un tutorial, hazte la siguiente pregunta: ¿es realmente necesario, va a ser de utilidad, va a aportar algo? Ten en cuenta que hoy en día existen programas y servicios de toda clase. Hay muchísimas aplicaciones que automatizan los procesos y hacen las cosas más simples para los usuarios. Por ejemplo, ya de nada sirve explicar cómo conectar un Home Theater cuando existen servicios como WireWize, que lo hacen automáticamente y hasta contemplan las configuraciones de dispositivos de diferentes marcas y modelos. Otro ejemplo, ¿hace falta escribir un tutorial sobre cómo hacer un backup de tus Favoritos de Firefox cuando Foxmarks ya lo hace por nosotros, a diario, manteniendo un backup en línea?

    Planea ahora. Piensa y te ahorrarás mucho trabajo y frustraciones. Planea ahora. Piensa y te ahorrarás mucho trabajo y frustraciones.

    2) Planeamiento
    ¿Ya sabes lo que quieres enseñar? ¡Perfecto! Pero, ¿sabes cuál es la mejor forma de hacerlo? Cuidado, no todos los tutoriales tienen procesos lineales. Por ejemplo, hacer un tutorial sobre vLite es simple, porque es el programa el que marca el orden y la sucesión del paso a paso. Muy diferente es explicar cómo ver películas en una Nintendo DS. En este caso, el paso a paso no está marcado por ningún software y se necesitan complementos externos para completar la tarea. Cuando sea así, es prioritario planear la estructura. Si no lo haces, la hoja en blanco podría ser tu peor enemiga.

    Ten a mano todo lo que vayas a necesitar. Como Batman. Ten a mano todo lo que vayas a necesitar. Como Batman.

    3) Herramientas
    Antes de comenzar a escribir, asegúrate de tener todas las herramientas que necesitas, más allá de las lógicas que intervienen en la realización del tutorial. Por ejemplo: ¿Necesitas capturas? ¿Debes grabar un vídeo de la pantalla? ¿Tiene batería tu cámara? Parece una tontería, pero escribir es una tarea que requiere concentración. Si debes interrumpir la redacción a cada rato, probablemente demores el triple. Lo que es peor, la frustración hará que precipites tu obra o la termines de mala gana. Y eso siempre se nota.

    ¿Todo listo? Ya puedes comenzar a escribir.

¿Y tú, qué opinas?

  • #1 <a href="../../foro/member.php?u=4054" target="_self">armnddopree</a>
    armnddopree viernes, 04 de julio de 2008, 14:45

    COMO Batman!? pero batman hacía trampa... como hacía para saber con antelación todo lo que iba a necesitar? igual que 007... tramposos...

    Responder >> Attention Minus Plus Votos: -1 de 1
  • #2 crystian
    crystian domingo, 06 de julio de 2008, 00:42

    muy bueno, es basico, pero es necesario! ;)

    Responder >> Attention Minus Plus Votos: 1 de 3
  • #3 Anónimo
    Anónimo martes, 12 de agosto de 2008, 14:44

    Gracias por el tuto me ha sergvido de mucho

    Responder >> Attention Minus Plus Votos: 1 de 1
  • #4 anoniimo
    anoniimo miércoles, 14 de abril de 2010, 03:01

    nnoooooooooooooooooooooooo que chanda

    Responder >> Attention Minus Plus Votos: 0 de 2
  • #5 Meta
    Meta miércoles, 28 de julio de 2010, 22:42

    Si, se lo que es hacer tutoriales paa los demás más que para uno mismo. Se tarda mucho tiempo. No sabes lo que es hasta que hagas uno, y bien hecho.

    http://electronica-pic.blogspot.com/2010/07/interfaz-puerto-paralelo-lpt.html

    Saludo.

    Responder >> Attention Minus Plus Votos: 0 de 0
  • Cargando...Cargando...

  • nuevo comentario
    Nombre

    Campo obligatorio

    Email

    Escriba una dirección de correo electrónico con el formato sunombre@ejemplo.com.

    Campo obligatorio

 
Ir arriba