DEV Community: JuanDArdilaG

2. Un Github bien cuidado.

JuanDArdilaG — Tue, 14 Nov 2023 17:24:54 +0000

Este post es la versión escrita del episodio 3.2. Un Github bien cuidado (reedición) del podcast Sensei: tu guía en el mundo de la programación.

Photo by Adam Winger on Unsplash

El día de hoy vamos a hablar acerca de Github, a conocerlo y conocer su importancia para que refleje de la mejor manera nuestra experiencia y conocimientos.
Esta será una importante carta cuando nos presentemos como programadores o cuando otras personas quieran ver un poco de lo que hacemos.

Antes de entender cómo podemos aprovechar Github, vamos a entender qué es.

¿Qué es Github?

Github es un servicio de alojamiento de repositorios Git. Es decir, una página dónde podemos subir nuestros respositorios Git, compartirlos, colaborar en repositorios con equipos y descubrir repositorios de otras personas y empresas. Y es que Github es elegido por muchas empresas y proyectos para almacenar sus repositorios de código debido a su facilidad de uso y su amplia funcionalidad. Actualmente Github es un servicio propiedad de Microsoft quien lo compró en junio de 2018 por 7.500 millones de dólares. Y si te preguntas qué es un repositorio Git. Bueno, Git es un sistema de control de versiones, que es básicamente un software que nos permite trabajar en nuestro código guardando puntos en el tiempo a los cuales poder volver en un futuro si lo necesitamos. Una explicación rápida y no muy completa por lo que si quieres profundizar más en qué es sistema de control de versiones y por qué es tan importante para un programador te recomiendo escuchar el episodio correspondiente del podcast, y si aún te quedan dudas, puedes enviarme un mensaje directo, más información en la descripción.

Aclarado entonces que es Github, podemos continuar.
Y aunque hay alternativas a Github como Bitbucket, Gitlab o incluso montar nuestro propio servidor Git, Github es la opción más popular y es en la que nos centraremos el día de hoy, pero aplica igualmente lo que veremos para cualquier alternativa.

Buenas prácticas

Si estás empezando a programar, desde este mismo momento, deberías empezar a procuparte por adquirir unas buenas prácticas que te faciliten crecer tus proyectos si quieres o lo necesitas y te van a preparar para trabajar con otras personas en un lenguaje común y claro, y no me refiero a tener las mejores prácticas desde los primeros días, pero sí a preocuparte por irlas aprendiendo.
Y sin duda un buen hábito que es muy útil aprender pronto es a usar un control de versiones en el código que escribas y a usarlo correctamente.

Entre las ventajas de usar adecuadamente Github está que nos permite mostrar nuestra constancia a lo largo del tiempo que vamos programando, ver un historial de lo que hemos producido, de nuestro avance, de los lenguajes y tecnologías que hemos trabajado, y también para mostrar nuestro manejo de git y que a través de los commits y el historial de commits, puedan ver en una forma mucho más general nuestro proyecto y cómo hemos ido avanzando en él.
Otra de las ventajas es poder tener un sitio para almacenar y compartir tus proyectos, sea un proyecto pequeño o grande, que este no solo viva en tu computador personal con riesgo de perderse, sino que puedes usar Github para alojar tus proyectos y ver tu progreso en el tiempo o retomar un proyecto viejo para incorporar algo nuevo que aprendiste.

Y aunque nos interesa mostrar nuestros avances conforme vamos aprendiendo, debes tener cuidado de no usar Github simplemente para subir las tareas o asignaciones de los cursos o clases y olvidarlos por siempre, sino usarlos como un punto de partida para seguir construyendo tu conocimiento sobre ellos y darles tu toque personal adicional que los diferencie de una simple tarea.

Consintiendo tu Github

Entonces, una buena estrategia para conseguir un Github bien cuidado es ir puliendo constantemente tu perfil, que se vea que los proyectos que montamos ahí tienen un sentido y que los vamos actualizando o que vamos mejorando su documentación para incluir detalles de qué hicimos y por qué lo hicimos y con eso demostrar una mejora constante en nuestro aprendizaje.

Y es que debes tener en cuenta que cuando escribes código, vas transformando las ideas, o codificándolas en un lenguaje de programación que es más complejo y abstracto que el lenguaje natural, por lo que cuando quieres entender qué hace un fragmento de código debes hacer en tu cabeza un proceso inverso de decodificación para entenderlo al llevarlo de nuevo a un lenguaje natural. Ese proceso de decodificación no es gratuito, y muchas veces no es rápido ni sencillo. Es por eso que un buen proyecto debe estar documentado. La documentación es esa explicación en lenguaje natural de qué hace el código y qué no hace, sus configuraciones, limitaciones, intención de uso, entre otros detalles que están en el código pero no de una forma clara y entendible para cualquier persona que quiera acercarse a nuestro proyecto sin necesidad de que sea otro programador o que conozca el proyecto de antemano. Para documentar nuestro proyecto podemos usar un archivo README, que verán las personas que visiten nuestro repositorio, un README no es más que un archivo .md o Markdown, que nos permite escribir documentación con un formato sencillo. En él podemos también incluir detalles como los participantes, las tecnologías usadas, las motivaciones o si el proyecto sigue activo o no. Aunque es adicional al código que escribiste, el hecho de llevar una documentación ayuda a que un proyecto tenga una vida más larga ya que explica a las personas la intención del proyecto, cómo pueden correrlo en su computadora o por qué el proyecto es interesante sin necesidad de estudiar el código en profundidad.

En Github podemos tener repositorios públicos y privados. Por lo que debes tener en cuenta si el repositorio que subes tiene información que pueda ser accesible para todos o no. Por ejemplo si tienes un contrato que te impide publicar el código o si es un emprendimiento personal que no quieres exponer puedes usar un repositorio privado, al que solo tú y personas con invitación puedan acceder. Y si lo que quieres es montar un proyecto que te gustaría mostrar al mundo, por el motivo que sea, usarías un repositorio público.

Como parte del mantenimiento regular a nuestro Github debemos estar revisando nuestros repositorios para retocarlos, o también si vemos que hay un proyecto que quedó medio iniciado, o que no le vemos mucho más futuro, por lo menos no el corto plazo y queremos sacarlo de nuestra lista pública de repositorios podemos archivarlo, volverlo privado, o en últimas podemos eliminarlo, siempre teniendo en cuenta que esta última es una acción irreversible.

Adicional a esto podemos destacar o marcar como favoritos hasta 6 repositorios que serán lo que queremos que las personas vean al entrar a nuestro perfil de Github y por los que nos conozcan los demás.
Y es que no debes olvidar que Github es también una red social donde puedes conocer y conectar con otros desarrolladores, ver sus proyectos, marcarlos como favoritos, e incluso colaborar en ellos.

Conclusión

Con esto en mente espero que empieces a profundizar en el control de versiones, una herramienta indispensable como programador, que empieces a familiarizarte con las herramientas, a tomar constancia y a escribir commits y documentación pensando en que otras personas pueden verla, sin duda esto te motivará a hacerlo un poco mejor, un poco más limpio cada vez.

Recuerda que la mejora es un proceso continuo simentado en la constancia, así que nunca es tarde para conseguir el objetivo de tener un github bien cuidado. Espero te haya gustado el capítulo.

5 consejos para convertirte en programador autodidacta

JuanDArdilaG — Thu, 09 Nov 2023 21:31:44 +0000

Este post es la versión escrita del episodio 3.1. El programador autodidacta (reedición) del podcast Sensei: tu guía en el mundo de la programación.

Photo by Jaromír Kavan on Unsplash

En este primer episodio vamos a hablar de una clase particular de programador: el programador autodidacta. Una especie única surgida de la curiosidad, una computadora, conexión a internet y tiempo libre. Mezclado con mucha pasión y una buena dosis de frustraciones.

Así que, si estás planeando convertirte en programador autodidacta acá te dejo algunos consejos para ayudarte a que sea más llevadero ese camino:

1. Momento de reflexión

El primer consejo que quiero darte es que tengas un momento de reflexión y establezcas un objetivo claro de por qué quieres empezar en el mundo de la programación ¿Dinero, libertad, gusto? y pongas esos motivos en la balanza contra el esfuerzo que puede suponer, las frustraciones, el tiempo, la dedicación en general. Tener un foco claro y suficicientemente motivante te va a permitir tener disciplina y constancia para cuando te sientas abrumado o si los resultados no se ven tan claros, ese norte te va a mantener en camino y hará más difícil que abandones. También en esta reflexión puedes entender si te gustaría arrancar el recorrido o si lo que ves al final no es apasionante, mi recomendación personal sería que profundices en qué te gusta hacer y se te da bien. No tienes que aprender a programar para tener un futuro, no debes aprender a programar para no quedar obsoleto en tu carrera, no debes aprender a programar para evitar quedar desempleado, con esos miedos fuera de la ecuación debería despejarse un poco más el panorama y si aún sientes dudas puedes tomarte el tiempo de reflexión necesario para entenderlas y darles un sentido.

2. Aprende a filtrar la información.

El segundo consejo está relacionado a la búsqueda de información relevante, y es que con la cantidad de recursos que nos ofrece internet es muy fácil perder el tiempo siguiendo pistas falsas o incompletas o excesivamente confusas. Por lo que debes convertirte cada día en mejor filtrador de información, por decirlo de alguna forma, teniendo presente cuáles son los formatos que mejor se acomodan a tu forma de aprender (como lectura, o visual, o auditivo) y a explorar los sitios donde encuentres un contenido que se adapte a ti (como tu nivel, tus preferencias o el idioma) y es que podemos encontrar diversidad de recursos: desde el programador con su cuenta personal de Youtube, cursos de meses dictados virtualmente por las mejores universidades del mundo, tenemos libros diversos, blogs, publicaciones, grupos de facebook, bootcamps, entre muchos otros. Hay de alta calidad, otros de calidad más bien regular, y muchas veces nos veremos atrapados invirtiendo nuestro valioso tiempo en promesas y confusiones. Por lo tanto filtrar de la mejor manera la información es crucial para lograr enfocarnos en un camino de aprendizaje más claro y más directo. Y recuerda que se trata de ser cada vez mejores aprendices, por lo que siempre es bueno salir de los recursos que ya conoces y usas y explorar otros nuevos. Podemos encontrar tanto recursos gratuitos, que pueden ser suficientes para la mayoría de los casos, o buscar recursos de pago.

Paréntesis:

No quiero dejar pasar este momento que estamos hablamos de buscar buenos sitios con recursos legales, para dejarte una página que uso personalmente para buscar libros o publicaciones tales como tesis universitarias con licencias menos restrictivas que permiten su distribución o porque los derechos de autor ya expiraron. La página es
Open Libra. Tiene tanto libros en español como en inglés y de diversos temas más allá de la programación.

Otro gran recurso que descubrí hace poco, este sí totalmente en inglés, es roadmap.sh, un sitio web en inglés que tiene una gran cantidad de caminos de aprendizaje, o roadmaps, para diferentes áreas de la programación, desde desarrollo web, hasta machine learning, pasando por bases de datos, seguridad, entre otros. Cada camino tiene una gran cantidad de recursos recomendados para cada paso, usualmente artículos o videos, y te permite crear una cuenta y tener un registro de tu progreso, esto te puede ayudar a tener un camino más claro y a no perderte de bases fundacionale s importantes.

3. Rodearte de programadores

El tercer consejo es que empieces a buscar estar con las personas a las cuáles puedas preguntarles, pedirles consejo, desahogarte. Idealmente personas con mayor experiencia que tú, idealmente alguien que represente un punto al que quieres llegar, una inspiración. Pero como no siempre es posible por lo menos alguien que ya haya recorrido un camino de aprender a programar puede servirte de guía y apoyo en este proceso para que no tengas que hacerlo solo. La recomendación sería que empieces a rodearte de personas del sector, puedes buscarlos en meetups, bootcamps, puede ser alguien que conozcas que también le guste programar, la idea es que consigas una experiencia inmersiva y puedas mantener la motivación al tener gente a tu alrededor con quien hablar de estas cosas e incluso llevar a cabo proyectos, que pueden ser proyectos sencillos para ir alcanzando nivel, recibir retroalimentación y compartir conocimientos e ideas.

4. Empieza por internet

El consejo número cuatro que te traigo es, si aún no sabes por dónde arrancar, puede que lo primero que quieras aprender sea HTML, CSS y JavaScript, ya que te ayudarán a conocer bases de la programación y de cómo funciona internet, además de ser una programacíon con resultados más visuales, puede ser útil cuando estamos aprendiendo poder ver los resultados de una forma directa y ver que empezamos a escribir código y este se ve reflejado en la pantalla. Estos lenguajes son la base de la programación web y sin duda te enseñará muchos temas vertebrales que aún hoy, teniendo herramientas más potentes como Angular y React se siguen basando en HTML, CSS y JavaScript.

5. Mentalidad de: Aprendiz de por vida

Como quinto y último consejo, debes tener en cuenta que a diferencia del aprendizaje tradicional, de instituciones educativas certificadas que avalan que un estudiante completó el plan de estudios definido por esa carrera en esa universidad y logró dominar los temas, cuando estés estudiando de forma autodidacta no será tan claro el "final" de ese estudio, ¿cómo saber si ya completé el currículo? ¿cómo saber si ya estoy completamente preparado? ¿quién lo define? La respuesta fácil sería: el mercado lo define, son las empresas te dirán lo que necesitan en los puestos de trabajo que van surgiendo y en los que desaparecen (y es que no debes olvidar lo cambiante que sigue siendo el mundo del desarrollo, con nuevos lenguajes y roles que aparecen cada tanto) y en parte muchas universidades construyen sus planes de estudio de esa forma, entre otros criterios, pero con esto se busca básicamente crear profesionales "empleables", que el mercado quiera. Aunque recuerda, esa es la respuesta fácil. La respuesta completa sería que el aprendizaje nunca termina y que la necesidad de aprender nuevas habilidades y adaptarse serán valiosas herramientas para el resto de tu vida.

Antes de terminar, y como consejo adicional recomendarte que estés con una mentalidad abierta y busques aprovechar lo mejor de ambas formas de estudiar, tanto aprendizaje guiado como autodidacta, y de esa forma volverte un aprendiz más integral. Sobre todo si tu principal forma de aprender es, o ha sido, a través de un aprendizaje guiado y más rígido en su contenido, como el que podemos encontrar en instituciones educativas por ejemplo. Como autodidacta vas a necesitar mucha autonomía e independencia, teniendo mucho cuidado de no confundir esto con la necesidad de hacerlo todo solo, y deberías preocuparte por no descuidar otras habilidades importantes como el trabajo en equipo y saber cómo, cúando y a quién pedir ayuda.