Muy buenas, soy Luis y esta vez les traigo un nuevo post.
Índice
Introducción
Así que ha creado un código modular estupendo, tiene un modelo extremadamente preciso con un tiempo de inferencia pequeño y ha enviado su código a Github: está sentado en las nubes.
Desafortunadamente, aquí es donde terminan la mayoría de los proyectos de código abierto. Antes de decirte por qué es tan desafortunado, déjame explicarte qué es el código abierto.
¿Qué es código abierto?
El código abierto se refiere a algo que las personas pueden modificar y compartir porque su diseño está disponible públicamente. Cuando envías tu proyecto a un repositorio público en Github, has contribuido al código abierto, y ahora cualquiera puede inspeccionar, modificar y mejorar tu código.
Las motivaciones de por qué la gente hace proyectos de código abierto varían. Algunos pueden querer obtener experiencia práctica de trabajar en un proyecto real, algunos simplemente aman la codificación y algunos quieren hacer del mundo un lugar mejor, pero una cosa es cierta, sin importar la motivación detrás del desarrollador.
¡La gente debe saber cómo comprometerse con su proyecto!
Es desafortunado cuando el código se envía a Github y nadie sabe cómo interactuar con su proyecto y Github lo sabe, por lo que hicieron provisión con algo llamado README que no se utiliza lo suficiente.
Obtener una precisión del 101% en el conjunto de datos Titanic no significa nada si las personas no saben cómo interactuar con su código.
La solución a esto es simple, pero lo pondrá millas por delante de muchas otras personas que piensan que la construcción de un conjunto de 3000 modelos para exprimir un 1% adicional de precisión es suficiente para que se noten.
Cómo escribir un archivo README …
Hemos establecido que un proyecto sin un archivo README no es útil ya que no proporciona información sobre lo que se ha construido; no estamos haciendo que el proyecto sea accesible para la mayor cantidad de personas posible. La pregunta ahora es, ¿cómo escribimos realmente un buen README?
Si eres como yo, la razón por la que no escribiste un README es porque no sabes cómo hacerlo. Por lo tanto, le mostraré exactamente lo que hice para aprender … Eche un vistazo a la guía a continuación:
¡Sí, sé que es mucho! Pero la siguiente parte es simple. ¿Cuáles son los 3 marcos populares utilizados en la ciencia de datos?
Me he vinculado a los perfiles de Github de cada marco, todo lo que le queda por hacer es visitar cada uno de los repositorios de Github y leer su README: es tan simple como eso (tenga en cuenta que tiene la muestra para ayudarlo si no está seguro)
Ahora que ya sabe qué escribir en su README, querrá agregar un poco de formato para darle un empujón adicional, así que a continuación, vincularé el mejor recurso en Internet que le informa sobre el formato Github.
Para concluir
En muchas situaciones, construir un modelo mejor es suficiente para llamar la atención, por ejemplo, en Kaggle. Sin embargo, muchas personas envían toneladas de código fuente a Github todos los días e incluso si tiene algo que parece que puede ser interesante, sin un README, la gente no tendrá ni idea de cómo navegar por su trabajo. Su trabajo es hacer que la tarea de involucrarse con su proyecto sea lo más simple posible y este simple cambio hará que su proyecto se destaque.
Añadir comentario