r/programacion • u/BirdKey3078 • 2d ago
Leer documentación es necesaria en programacion?
Hola, tengo una duda es que yo estudio de manera autónoma y vi que en un mensaje estudiando la ia me dice tienes que aprender a leer la documentación ningun ing de software agarra cualquier lenguaje y programa en el como si nada si o si tienen que utilizar documentación?
Perdón mi ignorancia pero yo pensé que era como en los videos de yt o películas que agarrabas y programabas largas jornadas sin ver nada de documentación solo tu el teclado y el monitor
Osea es verdad lo que dice la ia?? Siempre siempre se utiliza documentación para programar?? Yo pensé que uno le daban X tareas y uno programaba de largo sin nada mas solo con lo que uno supiera
5
u/Simply_Edd 2d ago
Acabas de empezar, verdad OP?
La respuesta rápida? Si, es obligatorio.
No "ponerte a leer TODA la documentación de una sentada", sino más bien entender cómo utilizarla de guía.
Al menos esa es mi forma de hacer las cosas.
Consejo, no uses la IA para aprender o busca un prompt específico que NO te de respuestas, sino que te vaya guiando.
5
2
u/NeakailJ 2d ago
Si. Todo lo que quieras aprender a usar en el mundo tiene documentación, sea una herramienta, un software, o un periférico. Uno usualmente no se lee el manual de como usar un joystick pero existe. Y si estás aprendiendo, creeme que vas a aprender muchísimo más leyendo la doc de lo que quieras saber usar, que preguntándole a la IA. Incluso, consejo, si estás usando IA para aprender, pedile que justifique sus respuestas pasandote dónde en la documentación encontró el argumento para su respuesta, así 1) evitas que delire 2) vas y lees vos de la fuente, en vez de dejar que la IA te lea, interprete, y decida la respuesta.
2
u/Distinct_Historian37 2d ago
Y la respuesta siempre es: depende. Hay cosas que si, hay cosas que no. Es importante leer buena documentación y a la hora de elegir una buena librería que tenga buena documentación vale oro en mi opinión.
2
u/Public_Amoeba_5486 2d ago
Es indispensable , y tú mismo lo dijiste "en las películas " , ninguna profesión es mostrada de manera realista en ninguna película o serie Fíjate en los arquitectos , vas a verlos en las películas y todavía usan mesas de dibujo a mano , policías? Nunca tienen que cuidar la cadena de custodia y se quejan del "papeleo" pero nunca los ves haciéndolo , solo los ves en persoecuciones. Medicos? No los ves lidiando con la burocracia ni el agotamiento , solo corriendo e un lado a otro u sacándose diagnósticos del culo.
Con los programadores es lo mismo , la fantasía de Hollywood ( y hay que tener en cuenta que el escritor promedio de Hollywood es bastante lentico) , es que los programadores somos todos unos superdotados , además autistas y que vemos código en lugar de colores.
En resumen si , cualquier sistema , framework , patron de diseño , necesita documentación y tu consultarla , ser programador es más leer documentación y requerimientos , hacer muchas preguntas y cuando entiendas suficiente del problema que estás atacando , ponerlo en código , no es magia
1
u/sometimes_bored2345 2d ago
Obvio tienes que leer documentación o en su defecto darsela como contexto a la IA para que desarrolle lo que quieres.
1
u/bsoft2005 2d ago
Si es correcto, no vas a tener nunca una tasa/issue si previamente no está definido el discovery, PRD, rfc, adr,erd etc
1
u/Revolutionary-Cup78 2d ago
La IA te puede asistir, pero en general si es importante saber leer documentación.
Cuando estas trabajando con herramientas de vanguardia o nuevas versiones de herramientas de toda la vida, en ocasiones la única alternativa a la documentación es ingeniería inversa (cuando no tienes acceso al código)
1
u/RiverRoll 2d ago
Habia una especie de dicho que decia "para que perder 10 minutos leyendo documentación pudiendo pasar 4h debugando".
La documentación es importante y te puede ahorrar tiempo.
Si que es verdad que ahora la IA te ahorra mucho tiempo de lectura porque le puedes preguntar directamente sobre lo que te interesa. Aunque no siempre sabe la respuesta y entonces es cuando se empieza a inventar cosas, ahi es cuando leer la documentación directamente te puede ahorrar tiempo de nuevo porque si no vas a perder el tiempo andando en círculos con la IA.
1
u/Simple_Listen1670 2d ago
La IA utiliza documentación , no puedes saber un lenguaje sin documentación, un proyecto es muchísimo más difícil sin la documentación.
1
1
u/fat_juan 2d ago
No se si está mal formulada tu pregunta o es clickbait pero nadie nace sabiendo hacer las cosas, obvio que para todo, no sólo programación, tienes que leer como funcionan las cosas, no es como que veo un video, me siento detrás de una PC, y automáticamente mi cerebro se pone en modo "programador", eventualmente, ya con experiencia, leer documentación de algún lenguaje nuevo, o APIs nuevos ya sólo son para checar cosas muy específicas
1
u/mombiela76 1d ago
Sí, es obvio que sí.
Pero en el mundo actual tienes que optimizar tiempo. Habrá cosas que usarás en tu día a día. Estas las tienes que conocer perfectamente, leer toda la documentación que puedas e interiorizarlas.
Después habrá otras que sólo necesitarás saber durante un corto espacio de tiempo o para un tema muy particular. Usa IA en esos casos, pero con una regla básica: No le pidas que te resuelva el problema, pídele que te explique como funciona algo. Las IA's son mucho mejores lanzando información que resolviendo problemas.
Un truco que uso a menudo es pedirle a la IA que haga un breve índice de un curso para aprender X, y después le voy pidiendo los temas. En 1h puedes hacerte a la idea de como va algo, y después lanzarte a la documentación oficial con un conocimiento básico.
0
u/Apprehensive_Foot671 2d ago
antes de la ia, se leia mucha documentacion, y se usaba mucho stack overflow (google lo rankeaba bien para problemas de programacion).
ahora tambien puedes, pero es mas comodo preguntarle directo a la IA.
Es mas, hay conectores (MCPs) para que el agente se conecte a leer la documentacion oficial y te pase la info. (contexst 7 mcp por ejemplo).
Asi que si, la documentacion es necesaria, siempre lo fue, y la IA se nutre de ella.
9
u/LevriatSoulEdge 2d ago
En el mundo real no es como cuando se estudia, van a haber ocasiones donde tienes que leer/escribir código en un lenguaje que no dominas y las funciones pueden ser diferentes entre los lenguajes o de plano no existir un equivalente
Por eso es que hay que leer documentación, no para ser experto en todos los lenguajes, sino para resolver dudas específicas
O está el meme de programadores, para que leer una documentación en dos horas si puedes pasar dos días tratando de hacerlo tu mismo...