Integración de desarrolladores de React a TypeScript

Hola, mi nombre es Silvana Santos y hoy te guiaré a través de lo que creo que son algunas de las mejores prácticas para incorporar a los desarrolladores de React a TypeScript. Así que un poco sobre mí. Soy ingeniera de software en Codecademy. Trabajo con React, TypeScript, Next.js, así como algunas tecnologías de backend y me apasiona compartir conocimientos y defender a los ingenieros en ciernes en mi empresa. Esto es algo que es particularmente importante para mí porque no hace mucho tiempo que comencé mi propio camino hacia la ingeniería de software. Así que siempre estoy ansiosa por apoyar a aquellos en su camino también. Y espero que hoy pueda ofrecer una perspectiva fresca sobre las incorporaciones, ya que normalmente es algo que los gerentes de ingeniería o los ingenieros senior manejan.

Entonces, la agenda para hoy. Primero, discutiremos algunos puntos problemáticos que muchos ingenieros, incluyéndome a mí, enfrentan cuando están aprendiendo TypeScript por primera vez. Luego identificaremos algunos principios que puedes seguir para asegurarte de crear una experiencia de incorporación efectiva. Y luego la mayor parte de nuestro tiempo lo dedicaremos a examinar cómo podría ser una experiencia de incorporación efectiva. Y luego haremos un breve resumen de todos los puntos clave de la sesión de hoy.

Entonces, los puntos problemáticos. Desde el momento en que un ingeniero abre por primera vez un archivo de TypeScript, puede comenzar a sentirse abrumado. Cuando no estás familiarizado con la sintaxis, TypeScript puede parecer bastante intimidante. Los archivos son mucho más robustos que los archivos de JavaScript a los que podrían estar acostumbrados. Y por lo tanto, se vuelve muy difícil para ellos identificar la sintaxis con la que ya están familiarizados en comparación con la sintaxis con la que no están familiarizados. Y una vez que superan ese shock inicial y comienzan a trabajar realmente en TypeScript, pueden sentir que TypeScript está en su contra, no con ellos, como tantas personas afirman. Y esto es especialmente cierto para los ingenieros que nunca han trabajado con lenguajes de tipado estático. Puede parecer que solucionas un error de compilación y de repente aparecen diez más en su lugar. Así que puede ser bastante frustrante.

Entonces, con esos puntos problemáticos en mente, podemos establecer algunos principios que nos ayudarán a dar forma a nuestras incorporaciones. Estos son solo tres principios que trato de tener en cuenta cuando construyo estas experiencias. El primero es crear un espacio seguro. Esto comienza alentando a los estudiantes a hacer preguntas y buscar ayuda, incluso más allá de la incorporación en sí. Pero puede ser mucho más que eso. Compartir tus propias experiencias, aprender un nuevo lenguaje o tecnología y hablar sobre las dificultades que enfrentas en el camino puede ser de gran ayuda para reconfortar a un ingeniero mientras aprende TypeScript. El segundo principio que trato de seguir es establecer paralelismos. Siempre que sea posible, es genial conectar las cosas que están tratando de aprender con las cosas que ya conocen muy bien. Por ejemplo, si estás tratando de enseñar un concepto de TypeScript, es genial cuando puedes conectarlo con el trabajo que han hecho en React. O si el ingeniero ha trabajado antes en Java, puedes conectar la sintaxis de Java con la sintaxis de TypeScript. El tercer principio que trato de seguir es permitir el descubrimiento. La mayoría de las personas no retienen la información muy bien cuando solo están escuchando pasivamente. Es mucho mejor que las personas prueben las cosas por sí mismas. Entonces, siempre que sea posible, trato de ayudar a los estudiantes a descubrir el poder de TypeScript por sí mismos. En este punto, hemos discutido los puntos problemáticos que enfrentan los estudiantes.

Los desarrolladores de React pueden enfrentar desafíos a lo largo de su proceso de aprendizaje. También hemos identificado algunos principios que podemos seguir para crear una experiencia de incorporación más efectiva. Pero es posible que te estés preguntando, ¿cómo se verá esto en la práctica? Bueno, profundicemos en eso. Hay muchas formas diferentes de estructurar una experiencia de incorporación, pero he descubierto que las masterclass realmente encarnan los principios que acabamos de mencionar. Este es el formato que suelo seguir. Los primeros 5 a 10 minutos se utilizan para iniciar la reunión. Es un momento para que todos en la sesión se conozcan. Luego puedes presentar qué es TypeScript y por qué es valioso para tu empresa. Luego, la mayor parte del tiempo se dedicará a la programación en pareja. Los ingenieros en la sesión se dividirán en grupos pequeños donde trabajarán juntos para completar pequeños desafíos. Los últimos 5 a 10 minutos se utilizarán para finalizar la sesión. Este es el momento para abordar cualquier pregunta pendiente, compartir recursos para que los ingenieros continúen su proceso de aprendizaje y recopilar comentarios sobre su experiencia.

Como dije, la parte más importante de la experiencia de incorporación en la masterclass es el tiempo de emparejamiento. Hay dos cosas que puedes hacer para asegurarte de que este tiempo sea útil. Primero, asegúrate de que cada grupo tenga de dos a tres aprendices y un mentor. La sesión debe ser dirigida por los aprendices, pero el mentor está allí para ayudarlos a desbloquear cualquier problema o responder cualquier pregunta que surja mientras trabajan en los desafíos. La segunda cosa que debes hacer es proporcionar a los aprendices un documento que los guíe a través de esos desafíos, y veremos cómo podría ser esa documentación más adelante. Hasta este punto, he mencionado los desafíos varias veces y es posible que te preguntes qué es un desafío y cómo se ve. Así que divido los desafíos en tres partes. La primera es la consigna, que le indica al grupo qué tarea deben completar. Luego viene una pista o varias pistas que los ayudarán cuando se queden atascados. Esta es una oportunidad para compartir recursos sobre el tema o proporcionarles pistas para ayudarlos a avanzar. Y con suerte, después de recibir algunas pistas y tal vez algo de orientación del mentor, podrán encontrar una solución y verificarla con la respuesta, que es solo un fragmento de código de la solución. Para tener una mejor idea de cómo podría ser un desafío, centrémonos en el tema de las anotaciones de funciones. Cuando intentas crear un desafío en torno a un tema específico, hay dos cosas que debes tener en cuenta. Primero, ¿qué podría dificultar la comprensión de este tema para los aprendices? En el caso de las anotaciones de funciones, hay dos razones por las que los aprendices podrían encontrarlo difícil. La primera es que escribir anotaciones de funciones requiere que tengas los fundamentos de TypeScript claros y cuando acabas de aprender esto hace unos minutos o 30 minutos, puede ser muy difícil recordar esa información y también se te pide que construyas sobre esa información. La segunda cosa que podría dificultar las anotaciones de funciones es que se pueden anotar funciones utilizando muchas sintaxis diferentes. Por lo tanto, es muy fácil que los aprendices mezclen las sintaxis. En este punto, debes preguntarte cómo puedo abordar estas dificultades y hacer que este tema sea más comprensible. En el caso de las anotaciones de funciones, hay dos cosas que puedes hacer. Primero, asegúrate de que los aprendices hayan comprendido los conceptos básicos antes de abordar este desafío, lo que significa que debes crear un desafío que cubra los conceptos básicos y hacer que lo hagan primero. La segunda cosa que debes hacer es dividir este desafío en varias partes, lo que te permite cubrir diferentes sintaxis en cada parte.

Entonces, veamos cómo podría ser el desafío. La Parte A les pide a los aprendices que escriban una lista de funciones utilizando una expresión de tipo de función. Aquí pueden ver que tenemos diferentes funciones que tienen diferentes entradas y salidas, para que practiquen la sintaxis con una variedad de funciones diferentes. Si los aprendices se quedan atascados en el camino, lo primero que hacemos es dirigirlos a la documentación. Si eso no ayuda, les brindamos una explicación detallada de la sintaxis y tratamos de relacionarla con algo que ya hayan aprendido en un desafío anterior.

Aquí pueden ver que les mostramos cómo están acostumbrados a declarar una variable básica de tipo cadena, y luego comparamos eso con cómo usarían esa misma anotación en una función. En este caso, solo tienen el nombre de la variable seguido de dos puntos. Y lo que sigue después de los dos puntos es el tipo. Y luego, lo que sigue después del signo igual es el valor, de la misma manera que lo harían normalmente en JavaScript. Con suerte, con esas pistas, podrán encontrar su propia solución y compararla con nuestras respuestas aquí. Y algo importante a destacar es que los enlaces que han visto en las diapositivas anteriores los llevan a un entorno de pruebas de TypeScript, por lo que es muy interactivo y tienen un lugar para jugar con el código. Sí, como pueden ver aquí, les proporcionamos las respuestas para que puedan ver cómo se verá la sintaxis con diferentes tipos de funciones que tienen diferentes entradas y

resultados. Pasemos a la parte B. Este desafío les pide a los aprendices que agreguen anotaciones de tipo de parámetro y retorno a la misma lista de funciones que examinaron en la parte A. Esto permite continuidad y también facilita la comparación de las diferentes sintaxis. Y así, nuevamente, con las pistas, los dirigimos hacia la documentación. Queremos que se familiaricen con trabajar en la documentación de TypeScript. Pero si eso no es suficiente, también les proporcionamos un pequeño desglose de la sintaxis. Y, nuevamente, destacamos la sintaxis aquí al decir que están anotando el parámetro de la misma manera que lo harían en una declaración de variable. Y luego tenemos esta nueva sintaxis de tener dos puntos después del parámetro y lo que sigue después de esos dos puntos es la anotación de tipo de retorno. Y así, una vez más, con esas pistas y con la ayuda de su mentor, esperamos que lleguen a su propia solución, que pueden comparar con nuestras respuestas que les proporcionamos en el documento.

Entonces, en este punto les hemos proporcionado suficiente información para que puedan anotar los componentes funcionales de React. Ahora, obviamente, hay mucho más en las anotaciones de funciones, por lo que definitivamente podríamos agregar más cosas al desafío anterior. Por ejemplo, podríamos decirles que refactoricen sus anotaciones utilizando alias de tipo o algo así. Pero, como dije, en este punto tienen el conocimiento mínimo necesario para poder anotar los componentes funcionales de React. Entonces, nuevamente, para este tema, vamos a querer dividir el desafío en varias partes. Entonces, en la parte A, les pedimos a los aprendices que creen una interfaz que defina la forma de las props en el componente. Nuevamente, queremos asegurarnos en el componente. Queremos que esto sea comprensible. Comenzamos con una pequeña parte de la tarea. Como pueden ver aquí, tenemos un componente llamado curriculum card. Y todo lo que hace es recibir un objeto que contiene un título, una descripción y lo muestra. Entonces, si los aprendices tienen problemas para anotar o para crear la interfaz de las props de ese componente, primero los guiamos hacia la documentación. Pero aquí también les damos una pequeña pista y les decimos que si no están seguros acerca de la forma de las props, ¿qué tal si echan un vistazo a dónde estamos desestructurando las props? Eso podría ayudarles. Y así, con la documentación y la pista, esperamos que puedan llegar a su respuesta y llegar a esta interfaz aquí. Y también cabe destacar que en algún momento, tal vez en ese desafío que tuvimos al principio con los conceptos básicos, deberían cubrir las interfaces. Esto no debería ser la primera vez que los aprendices ven interfaces. Simplemente no hay suficiente tiempo en este taller o en esta charla para haber mostrado eso, pero solo quiero aclarar que esto no debería ser la primera vez que sus aprendices ven interfaces. Ya deberían haber sido introducidos a esa información en un desafío anterior. Genial, así que pasemos a la parte B, que les pide a los aprendices que anoten el componente utilizando una expresión de tipo de función o una anotación de tipo de parámetro/retorno

anotación. Entonces, nuevamente, utilizando el mismo componente de la parte A, esta vez les proporcionamos pistas ligeramente diferentes. Esta vez no hay documentación. Lo que les decimos es que primero, van a necesitar la interfaz que crearon en la parte A. Esa es una gran pista. Y luego, les hacemos una pregunta primero. Les preguntamos, ¿cuál es el tipo de retorno de un componente funcionalReact? Y con suerte, tendrían esto en algún tipo de interruptor, para que tengan un minuto para pensarlo. Y si no están seguros, les damos la respuesta aquí. Y decimos, un nodo de React, ese es el tipo de retorno. Ahora, eso no es completamente preciso, pero estamos tratando de guiarlos en esa dirección. Y tal vez más adelante, podamos explicar que eso no es completamente preciso. Y así, les damos esa advertencia. No se preocupen, es posible que estén un poco confundidos acerca de dónde viene esto o qué es. No se preocupen por eso por ahora. Una cosa a la vez. Y así, nuevamente, les proporcionamos la respuesta aquí. En el enlace, les muestro cómo hacerlo con las dos sintaxis diferentes. Pero solo con fines de esta diapositiva, mostré una.

de las sintaxis. Increíble. Entonces, después de pasar por este proceso de construcción de desafíos, hablando de las dificultades y cada uno de los temas. Así es como se vería el masterclass. Tendríamos el desafío uno, que cubre tipos básicos. Esto no es algo que explícitamente mostré en la sesión de hoy. Pero fue algo que dijimos que necesitan para el desafío dos, que cubre anotaciones de funciones. Y una vez que tengan ese conocimiento de las anotaciones de funciones, deberían estar en un punto donde puedan asumir el desafío tres, que son los componentes funcionales de React. Y, obviamente, hay muchas cosas que se pueden cubrir en esta sesión. Puedes ampliar más las anotaciones de funciones. Puedes agregar otros temas. Realmente puedes adaptarlo para aplicar las mejores prácticas que utilizas en tu empresa. Por ejemplo, podrías agregar un desafío cuatro, que cubre genéricos, y eso los ayudará a prepararse para el desafío cinco, que vuelve a visitar los componentes funcionales de React, pero esta vez los introduce al tipo React.fc. Entonces, eso es solo un ejemplo de cómo podrías construir sobre esta base que cubrimos aquí hoy. Y ahora, repasemos todo lo que cubrimos. Primero, aprender TypeScript puede ser difícil. Puedo decirte de primera mano que TypeScript no fue algo intuitivo para mí. Me llevó muchos intentos tener ese momento de revelación. Entonces, teniendo eso en cuenta, debes intentar que tus incorporaciones sean un espacio seguro donde tus aprendices puedan practicar con TypeScript. Y los masterclasses pueden ser un formato realmente excelente para lograr ese objetivo. Y cuando estés creando masterclasses, si decides que ese es el formato correcto para ti, debes exponer gradualmente a los ingenieros a los conceptos de TypeScript, y todo eso debe culminar en un caso de uso de React, como vimos aquí hoy. Eso es todo lo que tengo para ti. Aprecio que te hayas tomado el tiempo para ver mi sesión. Espero que hayas descubierto algunas formas de mejorar o tal vez si estás comenzando desde cero tus experiencias de incorporación. Muchas gracias.