Existen proyectos de código abierto muy complejos, y para algunos creo que podría hacer algunas contribuciones, y me gustaría poder hacerlo, pero la barrera de entrada es demasiado alta por una sola razón: para cambiar una línea de código en un proyecto grande, tienes que entenderlo todo.
No es necesario leer todo el código (incluso si lee, no será suficiente) y entender todas las líneas individuales y por qué, ya que el código probablemente está modularizado y compartimentado, por lo que hay abstracciones en lugar, pero incluso entonces necesita obtener una descripción general del proyecto para poder saber dónde están los módulos, dónde tiene una interfaz de módulo con otro, qué hace exactamente cada módulo y por qué , y en qué directorios y archivos ocurren cada una de estas cosas.
Llamo a esto descripción general del código , como el nombre de una sección que los proyectos de código abierto podrían tener en el sitio web o en la documentación que explica su código a personas externas. Creo que beneficiaría a contribuyentes potenciales , ya que podrían identificar los lugares donde podrían construir, los codificadores primarios involucrados, como podrían hacerlo, mientras escriben todo, reorganizar sus mentes y ayudaría a usuarios , ya que serían una ayuda para comprender y para informar mejor sobre los errores que experimentan y quizás incluso para convertirse en colaboradores.
Pero todavía nunca he visto uno de estos "resúmenes de código". ¿Por qué? ¿Hay cosas como estas y las echo de menos? ¿Cosas que hacen el mismo trabajo que estoy describiendo? ¿O es esta una idea completamente inútil, ya que todos, excepto yo, podemos entender proyectos con miles de líneas de código fácilmente?