Libertonia
Portada · Todo · Software Libre · Desarrolladores · Comunidad · Internet · Tecnología · Meta · Diarios
La documentacion...

es el codigo fuente   7 votes - 21 %
esta desfasada   8 votes - 24 %
esta incompleta   13 votes - 39 %
esta perfecta   1 vote - 3 %
me remito a los HOWTOs   1 vote - 3 %
la escribo yo   3 votes - 9 %
 
33 Total Votes
Ver: Modo: Orden:
Documentacion? Que documentacion? | 12 comentarios (12 temáticos, editoriales, 0 ocultos)
No sólo sysadmins (none / 0) (#1)
por jorginius ("jorginius" en Google Mail) a las Wed Jul 28th, 2004 at 03:24:54 PM CET
(Información Usuario) http://www.rodriguezmoreno.com

No sólo los sysadmins no tienen buena documentación, tampoco los desarrolladores la tienen, muchas bibliotecas y frameworks están sólo parcialmente documentados o no lo están en absoluto.

Desde el punto de vista del picateclas esto es lo que yo veo casi siempre:

Por un lado tienes un framework libre, gratis, sin royalties pero al que le tienes que echar un montón de tus horas para suplir la documentación. Como no tienes referencias se puede dar el caso de que descubras al final que no sirve para lo que quieres hacer, aunque la buena noticia es que al tener el código a lo mejor puedes adaptarlo (más horas).

Por otro tienes un framework propietario caro y con una buena documentación (o no), con información más precisa de lo que puedes o no puedes hacer con él y con menos posibilidades de ver que no te sirve después de estar dos meses lidiando con él o, en este último caso, con un servicio de atención detrás que haga las adaptaciones por ti incluido en el precio (o no).

En fin, es cuestión de la prisa que tengas, de lo que cuesta tu tiempo y de valorar si te merece la pena. Lo que está claro es que la documentación del software libre ni es buena ni es fácil de encontrar ni está actualizada, en general... E irse a mirar al código fuente es ya lo último: el código es la peor documentación posible a la que recurres cuando no te queda más remedio, y no te digo ya si no eres programador.


Abuelo Cebolleta cascarrabias =) (none / 0) (#2)
por jcantero (jcantero@agujero-negro.escomposlinux.org) a las Wed Jul 28th, 2004 at 04:10:41 PM CET
(Información Usuario) http://www.escomposlinux.org/jcantero/

<voice person="abuelo Simpson">

El tal Brian Jones es un nenaza. En mis tiempos, programábamos/cortocircuitábamos el micro con un clip Nº4. ¡Y no nos quejábamos tanto, leñe! :-P

Estos sysadmnis de hoy se han hecho unos blandurrios.
</voice>

--
"Papá, ¡Internet es más que una red pornográfica global!" -- Lisa Simpson


 
Y tu que haces por el software libre? (none / 0) (#5)
por TSDgeos a las Thu Jul 29th, 2004 at 12:23:18 AM CET
(Información Usuario)

Vale ya se que parezco alguien de barrapunto :D pero voy a explicar que pasa (IMHO):
- El programador no necesita manual de su programa, con lo cual no siente motivación especial para escribirlo
- El programador es un mal escritor de documentación para su programa ya que suele dar por obvias bastantes cosas
- Si pones a un programador entre el dilema de añadir features, corregir bugs o escribir el manual, nunca pensará que escribir un manual sea tan importante como hacer su programa aun más bueno.

Por lo tanto se necesita gente externa que ayude a escribir documentación.


Deja vu: Gonzo, Sinner, Pere y el rubio (none / 0) (#9)
por pbenavent a las Thu Jul 29th, 2004 at 07:54:41 AM CET
(Información Usuario) http://www.benavent.org

Deja vu es una expresión jcantero TradeMark (que os la explique él) y no seais cochinos, que el título no es una de esas orgias entre todos los que apareceremos en el título...

Gonzo compartía sus preocupaciones acerca de programar -que casualidad que hablé de comentar el código-, Sinner recoje mi entrada -gracias, yo también sufro en silencio- y el rubio es mi hermano que me tiene liado haciendole una página web, a mi, que no soy diseñador ...

La cosa es que ahora va el c*br*n y me pide que le haga un programita para llevar su empresa, -la contabilidad creo que la llevará con el contapus- y esto me pone en la situación un poco de Gonzo, Sinner y yo mismo conmigo.

Hazle algo a tu hermano, que el quiere verlo en Hasefroch XP, que uno sabe hacerlo en el sanex ese del pingüinito ... y te acuerdas de todos los Luser del mundo por ser uno de ellos...

¿Como hacer una aplicación en Linux que mi hermano pueda utilizar en Hasefroch? Documentada, por favor, que luego no habrá quien le meta mano.

Es un poco un cruce de las entradas de Sinner y Gonzo. He visto IDE's y aplicaciones ya hechas... había pensado en enchufarle un Apache2.X al Hasefroch, una PostgreSQL y hacerlo en PHP...

No soy desarrollador y necesito como todos no, más, la documentación para dentro de dos meses saber qué hacia una función y no romperme las meninges relendo código o comentarios en el código. Creo que un IDE bien acabado debe posibilitar que se documente como una parte más del proceso: ¿Sugerencias?

--
"El hombre es la medida de todas las cosas"
Protágoras


Documentacion? Que documentacion? | 12 comentarios (12 temáticos, editoriales, 0 ocultos)
Ver: Modo: Orden:
Menu
· crear cuenta
· FAQ
· búsqueda
· Fuentes de Noticias

Login
Nueva cuenta
Usuario:
Contraseña:

ecol Logo Powered by Scoop
Todas las Marcas Registradas y copyrights de esta página son propiedad de sus respectivos dueños.
Los comentarios son propiedad del que los escribe.
Los iconos de las noticias y el logotipo son propiedad de Javier Malonda.
El Resto © 2002 Escomposlinux.org y aledaños.

Puedes sindicar los contenidos de libertonia en formato RSS 1.0 y RDF 0.9. También se puede sindicar la cola de envíos pendientes de moderación.

El proyecto escomposlinux.org está dedicado a la memoria de tas

crear cuenta | faq | búsqueda