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.
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.
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.
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.
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�. :)
Muchas gracias por las sugerencias.
Saludos.
Un saludo,
--
Bernardo
