Reestructuración de Manuales/Documentación
Hola a todos, probablemente ya habrán leido o notado que ahora todos podemos contribuir a la documentación y que hay más libertad al respecto.
Actualmente la documentación de DH se encuentra abandonada y hay que mejorarla. Sin embargo, antes de empezar a editar un nodo creo que es importante qeu nos pongamos de acuerdo en una estructura final de cómo debería de ser la documentación.
Actualmente está así:
- Sobre Drupal
- Instalación y configuración
- Características y Módulos de Drupal
- FAQ
- Guía del traductor
- Terminología
- Sitios con Drupal
- Guia del usuario
- Otros artículos y manuales
Mi primera propuesta sería que se tratara de imitar lo más posible la estructura de documentación de drupal.org pero es importante que nos pongamos de acuerdo.
Saludos y espero comentarios.
Luis
- Inicie sesión o regístrese para enviar comentarios
Una gran propuesta y una sugerencia
Hola, me parece una excelente idea la reestructuración de la documentación aquí publicada, además se pueden intentar mejoras para reposicionarla frente a los foros. Me gustaría aportar alguna sugerencia a ver qué os parece:
- Podríamos incluir un apartado más dentro del árbol propuesto por Luis titulado por ejemplo "Qué módulos usar para..." y que mediante comentarios pudiera discutirse sobre los mejores módulos o scripts de código para solucionar problemas comunes como por ejemplo crear una galería de imágenes o un multiblog multiusuario ;)
Esto aportaría mucho para gente que ya ha aprendido a manejarse con el gestor y necesita empezar a mejorar sus trabajos.
- Por otra parte, podríamos también añadir enlaces a hebras del foro que resuelvan problemas comunes, promocionando ese contenido un poco más.
De todos modos, me parece un buen inicio la primera propuesta de Luis :)
La estructura que propone
La estructura que propone Luis, agregando la Guía del Traductor me parece muy buena también.
Yo hace poco que empece con Drupal, y verdaderamente tuve bastantes dificultades para encontrar la información, así que mirándolo desde esta perspectiva novata, la jerarquía que proponen me parece perfecta para la curva de aprendizaje del CMS.
Por otra parte, algo que a mi me parece fundamental y que, o bien no encuentro, o bien no existe, es un ESPACIO para colocar tutoriales de modulos específicos. Clarifico un poco mi idea:
Faltaría una rama en "modulos contribuidos", que sea específicamente para que vayamos agregando guías de como configurar adecuadamente un cierto módulo X, junto con algún ejemplito para ilustrar la explicación.
Es algo que no puedo encontrar por ningún lado, y a veces uno no termina de sacarle el jugo a ciertos módulos, por no tener el conocimiento necesario para utilizarlos en su forma más óptima.
Esa es una sugerencia.
Finalmente, estoy a disposición para ayudar en todo lo que esté a mi alcance.
@mariano86 sobre "Temas que
@mariano86 sobre "Temas que debería conocer para usar drupal" tienes razón, creo que hay que agregarlo en el libro de Getting Started en Antes de Empezar.
Probablemente sería bastante dificil escribir sobre css/html como tu mencionas pero creo que todos tenemos varios links a información útil y tutoriales sobre css y html.
@maniatico: tienes razón, por algúna razón olvidé ingresar esta parte, creo que incluso podríamos crear todo un nuevo libro con maneras de participar. no sé como veas esto.
sobre lo de que las personas consultan poco los manuales y preguntan en los foros no podría estar más de acuerdo, no eres el único que piensa igual.. mi teoria sobre esto es que la documentación no está muy organizada y le falta información y esa es la razón por la cual los usuarios preguntan en lugar de buscar.. también creo que con una mejor documentación podríamos incluir links de la documentación en las respuestas a los foros, por ejemplo, cuando se pregunta "puse mi sitio en mantenimiento, cerré mi sesión y no sé que hacer" que se ha preguntado como 1000 veces.
sobre cómo darle más importancia a la documentación creo que ya pensaremos en alguna otra idea junto con los administradores de drupal hispano, posiblemente haya que mover el bloque de la búsqueda más arriba o ya veremos que se propone.. no digo que no tengas razón, al contrario, tienes toda la razón, pero creo que este sería un segundo paso que tendríamos que dar una vez que logremos adecuar y reorganizar la documentación.
saludos
Luis, esa estructura se me
Luis, esa estructura se me hace perfecta, aunque pienso que se debería incluir "Guía del traductor" en el primer novel de jerarquía.
Por otro lado (de pronto queda fuera de este post pero tiene algo que ver) lo que he notado es que las personas consultan muy poco estos manuales ... por lo general se avalanchan directamente a preguntar en los foros, lo cual no está mal (aceptemolo, esta plataforma es sobre todo un foro y los demás elementos parecen ser totalmente secundarios). Se debería de pensar una forma de darle más importancia a la parte de los manuales.
Por otro lado es muy probable que ocurra lo que a mi me ocurre con la documentación en drupal.org: es tan robusta y compleja que no se por done empezar ... muy pocas veces me dirijo directamente a esta documentación (a menos que sea algo muy general como la guía de theming o de creación de módulos o algo así). La mayoría de veces aterrizo en estas páginas es por medio de una búsqueda de google o de una búsqueda en drupal.org ...
deberíamos tomar la delantera y pensar en formas alternas para encontrar la información que se necesita (¿tags libres?)
Probablemente los puntos que acabo de mencionar salgan de lo que se puede hacer en este momento, pero lo dejo como una observación.
Aquí está mi primera
Aquí está mi primera propuesta después de analizar la documentación de drupal.org, he mantenido los nombres de los libros en inglés, creo que los deberíamos de mantener hasta no tener una estructura fija y una vez que esté definida pensar en nombres claros y sencillos para los mismos.
Cada * significa un libro nuevo, igual que en drupal.org
Creo que está bastante claro, probablemente la única confusión que se pueda dar es en la parte de "snippets", ya que hay snippets y hay theme snippets.
Es muy importante que participemos para dejar una estructura que nos sirva a todos y en la cual todos podamos trabajar y que sobre todo estemos conformes con ella.
*Getting Started
Antes de Empezar
-- Conceptos y terminología
-- Entendiendo las Versiones de Drupal
-- Qué hacer si tengo problemas
-- Dónde descargar módulos
-- Dónde buscar más información
Guia de Instalación
-- Requerimientos
-- Descargar Drupal
-- Permisos a settings.php
-- Crear la base de datos
-- Correr el instalador
-- Problemas frecuentes de la instalación
Diferencias entre Drupal
-- 5.x a 6.x
Migrando a Drupal
-- Migrando de Joomla
-- Migrando de Xoops
-- Migrando de Movable Type
-- Migrando de Wordpress
FAQ's
-- Problemas frecuentes en la Instalación
-- Contribuyendo a la documentación
-- Licencia
-- Asociación
*Beyond the basics
Módulos
-- Módulos del Core
---- Block
---- Node
---- Contact
---- Poll
-- Módulos contribuidos
---- Instalando Módulos
---- Comparación de Módulos
---- Documentación de Módulos
------ Views
------ CCK
------ Panels
------ Activity
---- Popularidad de Módulos
Actualizar Drupal
Upgrade Drupal
Tutoriales
Snippets
*Theming
Drupal 6
-- Anatomía de un theme
-- Regiones
-- PHPTemplate theme engine
-- Theme override
Prácticas recomendadas
Themes contribuidos
Tutoriales, videos y Cómos
Theme snippets
*Developing for Drupal
Configurando un ambiente de desarrollo
Guía para desarrollo de módulos
Drupal API
Standards, seguridad y prácticas recomendadas
Agreguen sus propuestas
Saludos
Luis
Yo agregaría tal vez un
Yo agregaría tal vez un "Temas que debería conocer para usar drupal"
Muchas personas llegan pensando que Drupal es la panacea y nunca vieron lo que es CSS, después vemos que las preguntas en los foros son mitad HTML/CSS mitad drupal.
Por lo demás me parece muy sensata la organización.
Tal vez buenas prácticas debería estar a varios niveles. No solo en desarrollo.
Saludos!
Mariano
Yo también soy de la idea de
Yo también soy de la idea de que entre más parecidos mejor, de esta manera sería posible incluso poder trabajar en traducciones de documentación, en lugar de estar documentando todo y si la estructura es muy parecida, no habría muchos problemas a la hora de definir en dónde va cada nodo..
Esta semana me pondré a analizar un poco más a fondo la manera en la que esta definida la estructura de handbooks de drupal.org y ya la escribiré aquí para ir viendo cómo quedaría con los nombres correctos en español.
Mientras tanto, a mayor propuestas, mayor posibilidad de éxito. Sería interesante también saber la opinión de personas nuevas en drupal y en la comunidad, finalmente ellos tal vez sean los más interesados en una documentación bien escrita.
Saludos
Hola Luis, Me alegro mucho
Hola Luis,
Me alegro mucho que la documentación haya sido abierta a todos los usuarios, espero que esto ayude a mantenerla actualizada y a ampliarla.
En cuanto a tu comentario, estoy de acuerdo que debería estructurarse la documentación de una forma similar a como se encuentra en drupal.org. Para ser sincero la de drupal.org.es la encuentro un poco confusa.
De pronto propondría una presentación más parecida a la de http://drupal.org/handbooks
Creo que la clasificación debría presentarse de una forma acorde a los pasos que se siguen al aprender y utilizar Drupal:
Espero mis comentarios hayan sido pertinentes.