Los 5 principios de un gran tutorial de programación

En los últimos años, muchos programadores se han convertido, casi sin saberlo, en educadores.

Con el aumento creciente de personas que desean aprender a codificar, ha habido un aumento correspondiente en el número de personas dispuestas a enseñarlo.

Hay muchas paradojas en el campo de la programación. Por ejemplo, cuanto más código de otras personas use (es decir, a través de los paquetes npm de JavaScript o de los paquetes Composer de PHP), más simple se vuelve la implementación de su propio código, mientras que al mismo tiempo, más compleja se vuelve su base de código general.

Muy a menudo, encontramos que una cosa que parece ser completamente opuesta a otra es de hecho la causa de esa otra cosa.

Otro ejemplo de esta paradoja es el síndrome del impostor, que puede definirse como una falta de reconocimiento interno de su propio nivel de conocimiento y logro. Es un tema comúnmente discutido dentro del mundo de la programación, pero uno cuya causa y efecto subsiguiente rara vez se mencionan.

La cosa es que probablemente seas mucho mejor programador de lo que piensas. Por lo tanto, debe ser consciente del efecto del síndrome del impostor y la manera paradójica en la que cambia la forma en que enseña.

Primero veremos cómo afecta exactamente el síndrome del impostor a su enseñanza. Luego, veremos el papel de la empatía en el proceso y cómo es crucial para superar el síndrome del impostor y crear mejores tutoriales. Luego, compartiré contigo los cinco principios para crear un excelente tutorial de programación.

Por qué el síndrome del impostor conduce a una enseñanza deficiente

Cada vez más personas han llegado a admitir gradualmente sus propios sentimientos de síndrome del impostor. La causa también ha comenzado a surgir simultáneamente.

Parece que la razón principal por la que ocurre el síndrome del impostor es que, aunque la mayoría de las personas que lo experimentan son de hecho muy competentes, desafortunadamente sobreestiman el nivel de conocimiento de otras personas en proporción al propio.

Esencialmente, lo que esto significa es que la mayoría de los programadores que se sienten impostores se sienten así porque suponen que su propio nivel de conocimiento es también el nivel de quienes los rodean.

Por lo general, estos programadores se equivocan.

Lo irónico del síndrome del impostor a la hora de compartir conocimientos es que a menudo, por el efecto paradójico que tiene, la persona que se siente impostora acabará “entregando en exceso” a su aprendiz. Como sienten que no saben lo suficiente, tratan de demostrar cuánto saben.

La paradoja es que finalmente terminan perdiendo el blanco. Otra forma de verlo es que los programadores con síndrome del impostor asumen que sus alumnos ya saben lo que saben. Y esa suposición lleva al profesor a compartir en un nivel más alto de abstracción, lo que significa que puede perder lo que los alumnos no saben.

Estas lagunas en el conocimiento no permiten que su alumno construya su «estructura de conocimiento» de la misma manera que usted lo hizo.

Esta falta de coincidencia de perspectivas lo aleja de su potencial alumno.

Esos vacíos deben llenarse primero.

¿Pero cómo haces eso?

Empatía y cómo generar conocimiento de manera eficiente

El ingrediente clave en cualquier intercambio de información es Relevancia.

Lo que es relevante depende de las necesidades de la parte receptora, así como de la capacidad de la parte donante para satisfacer esa necesidad.

Esta alineación o comprensión de las necesidades se puede resumir diciendo que las dos partes se identifican entre sí.

La empatía es lo que permite que la transferencia de información tenga su relevancia, permitiendo así que se transmita de la manera más eficiente posible. La empatía es un componente clave en la enseñanza; cuando crea empatía con su estudiante, puede crear tutoriales efectivos.

También es a través de la empatía que puede comenzar gradualmente a construir una comprensión de la estructura del conocimiento dentro de la mente de otra persona.

El componente clave de una enseñanza eficaz.

Que es simplemente, como hemos dicho anteriormente, un intercambio de información.

Examinemos a continuación, describiendo lo que creo que son los cinco principios clave de todos los grandes tutoriales de programación.

5 principios a seguir para excelentes tutoriales de programación

Quizás nunca hayas considerado cómo la empatía puede ayudarte a hacer mejores tutoriales de programación. Si es así, tal vez no esté seguro de cómo proceder. ¡Pero no te preocupes! Estos cinco principios definitivamente lo ayudarán a comenzar bien.

Tenga una profunda empatía con su lector y evite hacer suposiciones de conocimiento

Cuando hablamos de empatía en el co

En el contexto de la enseñanza de tutoriales de programación, lo que queremos decir es que tiene una imagen relativamente precisa de lo que su alumno ya sabe.

Puede desarrollar esta empatía realizando una investigación sobre su alumno. Esto se puede hacer primero obteniendo una comprensión razonable de quién es su alumno objetivo, especificando el nivel de conocimiento de su alumno objetivo, dónde suelen pasar el rato y compartir en línea, y de qué suelen hablar.

Si, por ejemplo, estaba enseñando un tutorial de React, podría ir a un sitio de la comunidad como Reddit y buscar el subreddit / r / ReactJS.

Supongamos que se dirige a desarrolladores principiantes de React con aproximadamente uno o dos meses de experiencia. Puede hacer una búsqueda de «uno o dos meses» o «principiante» en el sitio y comenzar a leer las publicaciones.

A medida que lea, comenzará a tener una idea de lo que ese alumno en particular sabe y no sabe.

Un ejemplo de esto es TheNetNinja—Una serie de tutoriales gratuitos basados ​​en YouTube que lo guiarán paso a paso a través de las nuevas tecnologías.

Lo bueno de esta serie es el estilo de presentación relajado, casi de sentido común, «ya tienes esto, hombre» que tiene TheNetNinja. Es probable que esto se deba al alto grado de empatía que tiene con sus alumnos.

Comprenda el tema lo suficientemente profundo como para poder usar metáforas para describirlo

El cerebro aprende principalmente mediante metáforas. Para que pueda enseñar usando este método tan efectivo, primero debe comprender las metáforas que realmente “funcionarán” con su alumno objetivo.

Suponiendo que ha seguido el primer paso para obtener empatía con su alumno objetivo, hacer esto debería ser relativamente fácil.

Un ejemplo de esto es Paul Graham; su lema es «Haz algo que la gente quiera». Se trata de construir y usar la empatía, mediante el uso apropiado de la metáfora dentro de su contenido educativo, incluso en sus tutoriales y artículos.

Tener un tono de conversación

Vea a su lector como un amigo con el que simplemente está conversando mientras explica un tema. La mejor manera que he encontrado para asegurarme de que la escritura fluya como una conversación es leerla en voz alta para ti mismo y ver cómo se siente.

Si tiene un tono de conversación relajado pero informativo, entonces está en el camino correcto.

Un ejemplo de alguien que hace esto bien es TheNewBoston. Prácticamente ha arrinconado el mercado de tutoriales en línea basados ​​en la personalidad, hasta el punto de que muchos de sus dichos ahora a menudo son copiados por otros creadores de tutoriales en línea. «¿Qué pasa, chicos? Este es Bucky» es probablemente su eslogan más conocido.

Guiar al lector

En última instancia, su objetivo es ayudar al lector a aprender algo. La forma más propicia para que eso suceda es que el lector sienta que lo está llevando a un viaje y que usted es simplemente su guía experto.

El ejemplo anterior, TheNetNinja, lo hace excepcionalmente bien en sus tutoriales.

Su formato es sencillo. Cuando presenta un tema nuevo, por lo general comienza mostrando primero cómo no hacer algo, o la forma alternativa y más difícil de hacer algo, que enseña una parte de lo que quiere enseñar. Luego sigue esto, con el enfoque más simple, que no solo le enseña algo nuevo, sino que también refuerza el punto fundamental anterior que describió con su primer ejemplo.

Utilice el enfoque constructivista al enseñar

Con un enfoque constructivista, el énfasis está en primero ganar empatía con su alumno, y luego, una vez que se ha formado un modelo mental del nivel de comprensión de ese alumno, se pasa a utilizar esa estructura de conocimiento que el alumno tiene como base para construir. arriba de.

Un ejemplo de esto es FromToSchool. Toda la filosofía de FromToSchool se basa en la premisa descrita en esta publicación. FromToSchool crea contenido que permite a los desarrolladores aprender nuevos lenguajes y marcos de programación, más rápido, utilizando el conocimiento de lenguajes y marcos que ya conocen.

Si le preocupa no saber lo suficiente para ser profesor, puede compensar en exceso con demasiado conocimiento.

Si compensa en exceso, podría terminar superando el nivel de conocimiento de sus estudiantes y, en última instancia, sobre sus cabezas.

Los tutoriales son sobre empatía

Seguir los principios anteriores le dará una base muy sólida para sus tutoriales. Al aplicar estos principios, le dará a su lector un marco sólido como una roca dentro del cual navegar por el nuevo conocimiento que está tratando de ayudarlo a aprender.

Al final, crear excelentes tutoriales de programación se trata de empatía: comprender las necesidades de sus lectores y lo que esperan de usted.

Al mismo tiempo, y para que esto suceda sin problemas, también debe comprender sus propias necesidades. En otras palabras, debe poder darse crédito y darse cuenta de sus fortalezas. Esto le ayudará a encontrar el equilibrio con sus lectores.

¡Buena suerte haciendo tus tutoriales!