Pausa para el café #43. 6 errores de programación que te impiden conseguir el trabajo de tus sueños. Cómo contribuir al software de código abierto por primera vez

6 errores de programación que te impiden conseguir el trabajo de tus sueños

Fuente: Medio Para encontrar trabajo como programador, es necesario tener un repositorio Git. Esta es una de las primeras cosas que considerarán los reclutadores. Para que su repositorio dé una impresión positiva, debe contener proyectos con cambios recientes. Muestra solo los proyectos de los que estés orgulloso, no cada línea de código que hayas escrito. Estos son los conceptos básicos para trabajar con un repositorio. Recuerde que, tarde o temprano, alguien revisará su código para ver si encaja bien en la empresa. Este será un momento decisivo para ti. Después de unos minutos, el reclutador decidirá si te invita a una entrevista. Y aquí hay buenas y malas noticias. La mala noticia es que un simple error puede perjudicar sus posibilidades de conseguir el trabajo. La buena noticia es que la gente normalmente no quiere profundizar en el código. Necesitan una comprensión general de su código y arquitectura. Así que no es necesario ser un genio, sólo es necesario ser un buen programador. Aquí hay algunos errores comunes que cometen los novatos. Evítelos y sus posibilidades de entrevista aumentarán drásticamente.

Comentarios obsoletos

Los programadores tienen diferentes opiniones sobre los comentarios. Algunos los aman, otros los odian. No podemos llegar a una conclusión común sobre si vale la pena comentar el código y en qué casos hacerlo. Pero todos son unánimes en una cosa: si tienes comentarios, deben coincidir con tu código. Existen comentarios para explicar el código. Cuando su código es complejo o poco claro, necesita ayuda para que los lectores lo comprendan. También debes cambiar tu comentario cuando cambies el código. Si no haces esto, tu comentario ya no será útil. Un mal comentario es mucho peor que ningún comentario. Para empeorar las cosas, los comentarios están resaltados en el código. Los IDE modernos resaltan los comentarios en un color diferente para que sean más fáciles de leer. Al agregar un comentario, estás colocando un signo de "léame" en el código. De esta forma se detectará fácilmente cualquier discrepancia entre el comentario y el código. Elige sabiamente tus comentarios y recuerda actualizarlos junto con tu código. De esta manera te servirán bien.

Combinación de bibliotecas y lenguajes con los mismos casos de uso

Antes de la primera entrevista, tuve que solucionar un problema de contratación. Era una aplicación web sencilla, así que escribí un código, busqué en Google algunas preguntas complejas y la aplicación estuvo lista. Durante la entrevista, el reclutador me preguntó por qué mezclé código jQuery con JavaScript simple en todo el código. ¿Mi respuesta? "Umm..." Para ser honesto, pegué algunos fragmentos de código de Stack Overflow. No pensé mucho en eso. El código funcionó, así que seguí adelante. Este error es muy común entre los nuevos desarrolladores. Estamos tan concentrados en resolver problemas en el trabajo que no prestamos atención a cómo lo hacemos. No te conviertas en uno de los novatos que cae en esta trampa. Examina cada línea de código y asegúrate de saber por qué la colocas allí.

repetición de código

No te repitas (DRY) es un dogma de programación. Crear abstracciones para código repetitivo es la esencia de la programación. Sí, puede resultar difícil al principio. Cuando quieres resolver un problema, lo haces de cualquier forma posible. Luego pasas a otras tareas y el código repetitivo permanece contigo. Puedes deshacerte de este hábito creando un conjunto de reglas para ti mismo. Cada vez que refines una característica, lee el código nuevamente y mira si hay algo que puedas hacer para cambiarlo. Recuerda que la primera versión del código suele ser incorrecta y puedes mejorarla. Cuando notes un código duplicado, tómate el tiempo para estudiarlo. De esta manera podrás encontrar la mejor manera de reescribirlo (por ejemplo, usando un bucle o creando una nueva función). Si realiza esta limpieza cada vez, obtendrá un código más confiable y elegante.

Errores no controlados

Es casi imposible crear una aplicación significativa que siempre funcione perfectamente. Ya sea que esté completando una base de datos o realizando llamadas a la API, se producen errores. Los errores no controlados no sólo pueden detener la ejecución de funciones individuales, sino que incluso pueden provocar que toda la aplicación falle. Anticipar posibles errores es señal de un programador competente. Cada vez que acceda o actualice datos externos, debe estar preparado para el peor de los casos. Marque problemas potenciales de una manera que no haga que la aplicación sea difícil de manejar. Esto permitirá a los lectores de su código (y quizás a usted) encontrar errores rápidamente. También le mostrará al reclutador que puedes escribir código coherente.

Falta de coherencia

La coherencia es el sello distintivo del software de calidad. Hace que el código sea más fácil de leer y mantener. El código creado con un estilo uniforme es más predecible y es más fácil evaluar el rendimiento del programa. En un nivel más alto de abstracción, es difícil lograr coherencia. Se necesitarán años para dominarlo, por lo que debes comenzar a aprender esta técnica lo antes posible. Recuerde crear títulos usando un solo idioma. Probablemente debería ser inglés, pero en proyectos personales puedes nombrar variables y funciones en cualquier idioma siempre que sea siempre el mismo idioma. Si eres coherente, no importa si utilizas tabulaciones o espacios. Crea o elige una guía de estilo y respétala siempre. También deberías utilizar una herramienta como Prettier . Realmente ayuda mantener el código formateado de manera consistente. Independientemente de las herramientas y estilos que utilice, utilícelos de forma coherente. Incluso si escribe código incorrecto con un estilo consistente, generalmente es mejor que un código bueno e inconsistente porque es mucho más fácil de corregir.

Malentendido de las herramientas.

En un proyecto típico, probablemente tendrás que utilizar alguna biblioteca externa. Muchos programadores instalan bibliotecas casi automáticamente porque se utilizan en todos los proyectos. Las bibliotecas externas son excelentes porque son una forma comprobada de resolver problemas recurrentes. Sin embargo, los nuevos desarrolladores a menudo no entienden qué bibliotecas están utilizando y terminan agregando una biblioteca encima de otra o reimplementando alguna funcionalidad existente. Cada vez que instale una biblioteca en su proyecto, lea o al menos vea la documentación. Verifique los métodos y propiedades que puede usar y asegúrese de comprender qué problemas debería resolver la biblioteca y cuáles requieren el uso de una herramienta diferente. De esta manera podrá elegir las herramientas adecuadas para el trabajo y explicar sus opciones.

Cómo contribuir al software de código abierto por primera vez

Fuente: Jamestucker.dev El otro día vi un tweet de Evan Yu (creador de Vue.js ) sobre un nuevo repositorio en el que estaba trabajando y me interesó. ¡Decidí que quería contribuir a ello! El problema es que nunca antes había contribuido a proyectos de código abierto y no sabía por dónde empezar. Pero no puede ser tan difícil, ¿verdad? Una vez que entré al repositorio, inmediatamente me quedé paralizado. “¿Qué diablos debería hacer?”, pensé para mis adentros. Si hago un PR (solicitud de extracción, solicitud de fusión), los especialistas probablemente destrozarán mi código. Siempre seré conocido en el mundo del desarrollo como el tipo que no sabe cómo trabajar correctamente con código abierto. Y mi carrera terminará. Afortunadamente, leí un artículo (no recuerdo dónde) cuyo autor aconsejaba que la primera contribución al repositorio de otra persona debería ser lo más discreta posible. Esto podría ser algo tan simple como corregir un error tipográfico. Y así lo hice. Leí la documentación del repositorio, encontré algunos errores tipográficos, abrí un PR y, he aquí, Evan aprobó mis cambios. ¡Soy oficialmente colaborador de Vue! ¿Quizás debería poner esto en mi biografía de Twitter?

"Eso es genial, pero ¿cómo empiezo?"

Bien, comencemos: te mostraré los pasos que puedes seguir para marcar la diferencia.

1. Encuentra un proyecto

Para inspirarte, piensa en tu tecnología o herramienta favorita. Digamos que trabajas con JavaScript y usas mucho Gatsby . ¡Mira su repositorio ! También puedes contribuir a uno de mis repositorios. Aquí hay una lista de mis proyectos frontend. Si tienes algo que te encanta o te resulta útil, ¡me encantaría que lo agregaras! Finalmente, Awesome First PR Opportunities es un repositorio gigante de proyectos de código abierto para principiantes. ¡Hay proyectos en 22 idiomas diferentes!

2. Decide cómo puedes contribuir

Mira el proyecto. Lea el archivo Léame. Escanea diferentes carpetas y archivos. Obtenga una comprensión de la estructura del código base. ¡Al hacer esto, podrás encontrar y corregir fácilmente el error tipográfico! Una vez que haya hecho eso, eche un vistazo a la sección Problemas del proyecto. Allí encontrará una lista de errores encontrados anteriormente o funciones sugeridas. Afortunadamente, muchos proyectos implican problemas dirigidos a principiantes. Creo que tu primera contribución debería ser lo más sutil posible, pero si quieres obtener reconocimiento rápidamente, depende de ti. Una vez que encuentre algo que pueda agregar al proyecto, deberá bifurcarlo.

3. Creando una bifurcación del proyecto.

Un fork (fork de un proyecto) crea una copia exacta del mismo en tu propio repositorio de Github.

4. Clonar el proyecto localmente

Luego clone el proyecto en una carpeta local usando la URL del proyecto.

git clone <project-url>

Aquí encontrarás la URL. Ahora que el proyecto está en su computadora, ábralo en un editor. Si cree que los cambios llevarán tiempo, asegúrese de sincronizar una copia del proyecto con el original para estar siempre al tanto de los cambios. Puede encontrar los comandos Git exactos para esto aquí .

5. Crea una nueva rama para tus cambios.

¡Es hora de hacer tus cambios/correcciones! Cree una nueva rama donde sus cambios surtirán efecto.

git branch <branch-name>

Puedes llamarlo como quieras, pero según mi experiencia podrás ver un patrón para nombrar ramas en el proyecto original. En este caso, recomiendo seguir la plantilla existente. Un buen nombre de rama para corregir el error tipográfico sería patch/typo-fix . Puedes cambiar a esta rama usando git checkout <branch-name> . ¡Ahora haz tus cambios!

6. Abra un PR (solicitud de fusión)

Entonces corrigió un error tipográfico evidente o actualizó un enlace roto. Estás orgulloso de tu trabajo. Quieres que todo el mundo sepa que eres uno de esos desarrolladores míticos que pueden codificar, borrar y ver Netflix al mismo tiempo. Envíe sus cambios a un repositorio Github ramificado usando git push -u origin <branch-name> . Vaya a su repositorio de Github bifurcado y abra un PR (solicitud de extracción). Nota: Si nunca antes ha realizado una solicitud de extracción, mire este video de Kent Dodds para aprender cómo hacerlo. Asegúrese de que su rama apunte a la rama maestra del repositorio de origen. Ahora está listo para agregar detalles a su PR. Asegúrese de que su título transmita claramente el contenido del PR. Agregue una descripción: si está solucionando un problema existente, asegúrese de incluir un enlace al mismo. Una vez que haya terminado con su descripción, envíe su PR para su revisión. Quien tenga la autoridad para aprobar las relaciones públicas probablemente revisará su solicitud dentro de unos días y realizará una de las siguientes acciones:

1. Fusionará los cambios inmediatamente.
2. Le pedirá que realice cambios.
3. Cerrará tu PR.

Tenga paciencia ya que el creador del repositorio puede estar ocupado con un trabajo de tiempo completo u otros proyectos.

¡Lo hiciste!

¡Ahora eres colaborador del proyecto de código abierto! ¿Cómo se siente? ¿Listo para crear tu propio competidor de Node.js? Espero que al hacer una simple contribución, las perspectivas para el futuro trabajo de código abierto sean menos desalentadoras. Para obtener más información sobre las contribuciones de código abierto, consulte las guías de código abierto .