Re: FAQ de la lista (ejemplo simple)
Buenas a todos,
Bernardo Arlandis Mañó wrote:
Javier Mora wrote:
¿En que formato te viene bien?
Cualquiera, lo más sencillo para mí sería que fuesen urls a documentos
del web. No quiero hacer copy&paste al FAQ como ya he explicado antes.
No soy partidario de escribir texto específico para el FAQ.
Quien pueda ayudar escribiendo y aportando documentación que lo haga
en los proyectos de documentación existentes. En el FAQ pondremos la
url al documento. Sí que se puede aportar texto específico si es
necesario a la primera sección del FAQ, aún así me gustaría que
quedase lo más breve y conciso posible.
Perdonad que me meta en medio de la conversación. Realmente no me gusta
mucho la idea de que todo el PUF (FAQ es en inglés si me lo permites)
sea a base de enlaces, pero comprendo tu punto de vista y además es
cierto, hacer un documento tratando todo en detalle, entonces lo que
hacemos es doblar esfuerzos. De acuerdo entonces. Y además coincido
contigo en que debería ser mas o menos breve y conciso. No se puede
hablar de todo, solo de lo mas común que se pregunte en la lista, y
enlaces a sitios de documentación, tal como has hecho.
Como primera aportación, la sección de "Problemas" la dedicaría a
cuestiones de problemas reales, por ejemplo, yo puedo haber configurado
/etc/lilo.conf a partir de ciertos documentos, pero a la hora de
ponerlo en
marcha surgen ¿problemas? en el arranque.
No se puede responder a todos los problemas que alguno haya tenido
alguna vez. Para que sea un FAQ deberían aparecer los problemas más
comunes y que más se preguntan en la lista, que a su vez por lógica
deberían ser los que estan peor documentados o, lo que suele pasar,
que la respuesta está un poco oculta. No obstante, es discutible, tal
vez haya cosas que valga la pena incluirlas como por ejemplo un
problema conocido y con la solución demasiado escondida.
Otra vez de acuerdo contigo, no se puede responder a todos los problemas
de todo el mundo. Este en concreto si es algo que mas o menos se repite,
y por ejemplo la última vez que ha salido se ha dado a conocer los tipos
de errores a los que apunta lilo cuando peta, es un buen enlace que
podrias meter, a mi parecer, claro.
Crearía otra sección titulada "¿Cómo haria..." tal cosa
(posiblemente haya un título más apropiado), en la que pondría distintas
categorías (a decidir). Como ejemplo:
- Gestores de arranque
- Combinación de varios kernels
- Módulos
- Correo electrónico
- etc.
Ya te metes en el terreno de los manuales y howtos.
Quizas aqui, se podría hacer esta sección pero del mismo estilo,
apuntando a esos manuales y comos-howtos.
No se si sería oportuno poner un punto de sólo problemas o dentro de
cada categoría de las anteriores poner un punto de problemas. No lo
tengo
muy claro.
En cuanto a lo de las categorías, estoy de acuerdo con la sugerencia
de Toni, pero creo que no hace falta definir por adelantado las
categorías. No serviría de nada definir 40 categorías bien
estructuradas para después solo rellenar 5. Soy partidario de primero
recoger solo las preguntas que más aparecen en la lista y después ir
clasificandolas en categorias.
De nuevo si, coger las mas habituales y hacer categorías.
Creo que los FAQs deben ser ligeros para que a la gente no le suponga
mucho esfuerzo leerlo y encontrar lo que busca. Sino empiezan a
parecer manuales. Y para eso mejor trabajar en los manuales que son
más necesarios. Espero que entendais que no quiera duplicar
información y dividir esfuerzos con el FAQ. No vamos a echar a la
basura todo el trabajo que hay hecho por ahí. :)
Yo lo que entiendo, y además me parece un problema en linux, es
precisamente eso, la documentación a veces esta muy dispersa y duplicada
con lo que no se sabe por donde empezar, despista mucho por decirlo así.
Entonces este documento deberia enfocarse precisamente a eso, a dirigir
hacia una buena documentación, tal como se esta haciendo.
En principio, me parece bastante buena la labor que estas haciendo, el
documento ha mejorado con respecto a la primera versión. No soy ningún
experto, pero quizas también podrias poner un enlace al lipp, aunque se
pueda lleguar a él a traves de lucas, y no sea especificamente de
debian. Quizas también a algún tipo de documento de lectura rápida sobre
los comandos mas utilizados, para los mas nuevos en linux, a mi por
ejemplo me vino muy bien al principio, pero tenia varios y no uno común,
y era un poco... eso.
No te dejes, tampoco, unos buenos enlaces sobre como poner los locales
en castellano, que es algo que no para de salir, hace poco por ejemplo
yo pusé uno referente al tema, aunque fuera posterior a la instalación
de los locales.
Y tampoco con respecto a las tarjetas gráficas, las mas preguntadas son
nVidia y ATI radeon, algún enlace ahí a las instrucciones de nVidia que
son muy completas aunque en inglés. Con respecto a ATI no se si tienen
algún tipo de documento parecido, o si no, a alguna respuesta de la lista.
Con respecto a lo de las líneas de fuentes para instalar kde 3.0, gnome
2.0 y demás... bueno, comentais mucho www.apt-get.org, pero no se, a mi
personalmente no me ha ido muy bien, quizas por eso se repite tanto esa
pregunta, pero bueno.
Bueno, no se si me dejo algo mas, si se me ocurre algo, ya lo diré.
Otra cosa que pones en el PUF (yo sigo en las mias ^_^ ):
[PUF]
Copiado de Listas de correo <http://www.debian.org/MailingLists/> [En
este caso tal vez vale la pena copiar aquí las normas por lo importante
es que todo el mundo las tenga muy presentes]
[Había un documento que explicaba como preguntar correctamente en
listas. No recuerdo si estaba en inglés. ¿Alguien tiene el enlace?]
[/PUF]
Bueno, creo que te referias a como hacer preguntas inteligentes, he
estado buscando el correo y creo que era este:
[Correo]
-------- Original Message --------
Subject: como hacer buenas preguntas!
Resent-Date: Thu, 5 Sep 2002 11:35:59 -0500 (CDT)
Resent-From: debian-user-spanish@lists.debian.org
Date: Thu, 5 Sep 2002 11:35:22 -0500
From: "Diego Alvarez" <diegoalvarezz@epm.net.co>
To: "listadebian" <debian-user-spanish@lists.debian.org>
hola lista
como este foro esta tan activo, es bueno saber como hacer una buena
pregunta!
les recomiendo que vean esta pagina!!!
no se arrepentiran!!
http://www.sindominio.net/ayuda/preguntas-inteligentes.html
suerte!!
Diego Alvarez Zuluaga
Universidad Autonoma de Manizales
Estudiante.
Usuario Linux #280515
Icq#: 36670725
MSN# diegoaz@hotmail.com <mailto:diegoaz@hotmail.com>
[/Correo]
¡Ah! Para terminar, creo como te han dicho antes, que se debería hacer
incapie en que los que pregunten intenten dar los máximos datos posibles
sobre el problema, el que digan:
- Mi tarjeta gráfica no tira, ¿que hago?
no resuelve nada, es mejor decirles que intenten aportar datos, tipo:
[Pregunta con datos]
Mi tarjeta gráfica marca ESTA_MISMO modelo EL_MIO con el chip gráfico
SUPER_CHIP versión LA_ULTIMISIMA, y TROPECIENTAS megas de memoria no anda.
He estado configurando el XF86Config para mi teclado y ratón, y les
tengo puesto:
---- extracto XF86Config ----
y además para la tarjeta:
---- extracto XF86Config ----
pero cuando intento entrar en las X me suelta este error:
----- Quillo, esto no anda, te toca comerte la cabeza -----
Y he estado mirando el log, pero no termino de ver nada, os mando el meollo:
---- Y manda el log -----
[/Pregunta con datos]
Esa, a mi parecer que puede diferir del de los demás, es una buena
pregunta con chicha para empezar a dilucidar algo, no se como lo veis
vosotros.
También es posible que la gente no sepa por donde empezar a buscar
registros donde se pueden ver los problemas, quizas sea conveniente
comentarlo.
Bueno, no se que mas, yo creo que con esto ya va bien por un rato, ¿no?
Muchas gracias por las sugerencias.
Esperemos que te sirva algo de lo que he dicho ^_^
Saludos.
Un saludo,
Nos leemos.
Salud y Revolución.
Lobo.
--
Libertad es poder elegir en cualquier momento. Ahora yo elijo GNU/Linux,
para no atar mis manos con las cadenas del soft propietario.
---------
Desde El Ejido, en Almeria, usuario registrado linux #294013
http://www.counter.li.org
Reply to: