El parrafo en cuestion viene a decir tal que asi:
"Estimados desarrolladores de Open Source: Nosotros, los sysadmins (administradores de sistemas) estamos cansados de toda la porqueria que nos habeis estado lanzando. Parece como si todos estos anyos hubieseis estado pensando que nosotros, los sysadmins, somos desarrolladores. Y por consiguiente "el codigo es la documentacion". En el mundo real, no somos desarrolladores. Somos administradores de sistemas, y por eso es por lo que la palabra "desarrollador" no aparece en nada que tenga nuestro nombre -- por consiguiente, vuestro mantra no hace puta gracia".
Con esta provocadora introduccion, Brian Jones, en el articulo "!Es la docuemntacion, Estupido!", de la columna SysAdmin to SysAdmin se queja y enumera las razones porque los SysAdmins no usamos todo ese codigo "guays" que con tanta pasion y devocion generan tantos desarrolladores de productos OpenSource.
Y yo me he quedado pensando. ?Tiene razon Brian? ?O se trata acaso de otra excusa-BOFH?
Pues, la verdad, tiene razon. Un numero considerable de productos que he probado porque, al parecer, me iban a solucionar unos problemas, han resultado ser un autentico lio debido a la falta de documentacion, o la falta de documentacion clara o a la falta de documentacion actualizada.
No me sirve que me digan RTFM, si el Puto Manual no esta al dia. Si en cada producto tengo que probar, en orden, man foobar, pinfo foobar, foobar --help, foobar -h, foobar /?, less foobar.c .... que quereis que os diga, no me hace punyetera gracia. Y si el programa ya es en ocaml o en FORTRAN-orientado-a-objetos o cualquier otra aberracion de esas, el less foobar.$ solo me servira para perder el tiempo al leer los comentarios graciosos del codigo.
La versionitis esta muy bien... para el escritorio, la transparencia en el cursor y la ovejita que trisca por la pantalla. Pero para un programa de administracion de sistemas en imprescindible saber que hace, como lo hace, si tiene algun fallo conocido y como reportar problemas.
No me extranya que existen tantas paginas de "recetas", "HOWTOs" (algunos bastante desfasados) y similares en internet. Todas estas paginas existen, son tan famosas y son tan utiles porque la documentacion oficial es inutil. Si fuera util, ?para que re-escribir la docuemantacion?
Si eres un desarrollador de productos Open Source ten a tus usuarios en cuenta: escribe algo de documentacion. O pidele a un colega que la escriba por ti a cambio de un par de cervezas. El Open Source no necesita unicamente de desarrolladores: los escritores de documentacion son igualmente precisos y, si son Rubias, preciosas.
Si eres SysAdmin, ?has encontrado programas OpenSource que, aunque interesantes, hayas dejado estar por falta de buena documentacion? ?Sera por eso que siempre estamos creando nuestros scripts, porque nadie proporciona documentacion adecuaday tenemos que acabar reinventando la rueda porque al menos nuestra rueda conocemos como funciona?
Si no eres ni SysAdmin ni desarrollador, ?que opinas?
Salut,
Sinner
