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
A todos gracias por
A todos gracias por participar aquí, por conveniencia se ha creado un nuevo grupo en http://groups.drupal.org/spanish-documentation para seguir la discusión de este tema y otros más.
A todos los que quieran participar sean bienvenidos.
muy interesante Carmen,
muy interesante Carmen, espero que algunos puedan llenar el test y que después compartas los resultados con la comunidad, sin duda será muy interesante
A los seguidores de esta hebra
Hola, he creado un pequeño test (card sorting) en esta dirección http://websort.net/s/4893AB/, para participar habrá que poner un correo electrónico.
Como he dicho sólo existe la posibilidad de hacer 10 pruebas por lo que si alguien quiere hacerlo y para que yo pueda validarlo bastará con que deje por aquí un mensaje diciéndome que correo ha usado para el test.
Lo importante no es el anonimato sino que cada uno clasifique en tantos grupos como considere oportuno. Los grupos también pueden nombrarse como cada cual quiera.
El objetivo es ver qué términos manejamos de forma común y cuáles son ambigüos y por tanto debemos redefinir. Podemos hacer sucesivas vueltas predefiniendo grupos y clasificando algunos términos que queden descolgados, etc.
En resumen, vamos a intentarlo que no perdemos nada :D.
pd: tenéis razón respecto a los libros que no pueden editarse, seguro que si acordamos una estructura entre todos los administradores nos echan una mano para solucionarlo.
pd: si alguien echa de menos o de más algún término que avise y lo corrijo antes de lanzarlo definitivamente.
Saludos
Mariano86.. tienes razón..
Mariano86.. tienes razón.. algunos nodos no son editables por alguna razón.. lo noté desde hace tiempo y l averdad es que no quise detener el inicio de lap laneación de la reestructuración por unos cuantos nodos que no eran editables...
La razón es que probablemente no se necesite ya que los nodos que se puedan mover se moverán a otros libros y los que no podremos simplemente solicitar que sean movidos a algún libro nuevo llamado "Depreciado"..
Algo que he notado es que no
Algo que he notado es que no todos los nodos de la documentación son editables.
Me parece que los nodos creados por José Reyero estan creados con un filtro de entrada diferente al del que todos tenemos permitidos usar, y por esta razón algunos nodos no son editables. Ejemplos de esto:
Es algo que vamos a tener que solicitar que se solucione antes de empezar con la reestructuración.
Bueno, lo que voy a hacer es
Bueno, lo que voy a hacer es prepararlo, aunque sean con 10 participantes en dos servicios online gratuitos que haya a lo mejor nos sirve como pequeña guía. Luego lo anuncio al menos en mi blog para que salga en el Planet y envío un mail a los adminisrtadores para que lo incluyan si pueden... a ver qué acogimiento tenemos :)
buena idea sin embargo
buena idea sin embargo desgraciadamente la gran mayoría del os usuarios nuevos (que es a quienes va dirigido todo este esfuerzo) no participan aquí y no veo una manera en cómo podrían enterarse de la encuesta ya que no tenemos acceso a publicar algo en la página principal de drupal hispano.
Me alegro que os resulte
Me alegro que os resulte interesante. Podríamos incluirlo a modo de recetario pero yo no lo llamaría receta, podría confundirse con un "paso a paso" y no se trata de eso, sino más bien de sugerir soluciones posibles.
El lugar idóneo debería estar en mi opinión bajo Tutoriales, Snippets... no se me ocurre un nombre pero podría sugerir algo como "brainstorming" (en castellano "tormenta de ideas" claro :)) para que la gente se animase a proponer la suya un poco más.
No lo tengo claro, lo dejo un poco a vuestra disposición para ver de que manera encajarlo mejor.
Por otro lado, para organizar la información un poco mejor podríamos crear un cardsorting y pedir ayuda a los usuarios del portal, así es más sencillo y no tendríamos que especular tanto ;) el problema es que los servicios online gratuitos sólo permiten un máximo de 10 participantes, si alguien encuentra alguno ilimitado me ofrezco para crearlo y crear las categorías.
También me gusta la idea de
También me gusta la idea de reinamora, pero no lo nombraría "Qué módulos usar para ..." si no "Mejor forma para ..." ya que no necesariamente se trata de un modulo, podrían ser varios al mismo tiempo + configuración u otras herramientas.
Se me hace interesantes sobre todo para exponer varias formas para lograr algo concreto. Por ejemplo en "¿Cómo cambio el diseño del front?" o "¿Cómo hacer una galería de imágenes?" o "¿Como crear multiblogs multiusuarios?" son tareas que se pueden implementar de diferentes formas a Drupal, y muchas veces no hay una que sea mejor que todas, sino que depende del caso especifico de cada uno.
Yo creo que el mejor lugar para poner dicho item es "Tutoriales, videos y cómos" (que entre otras se podría llamar algo como "Tutoriales y recetas").
Reinamora también da un buen indicio y es que nos deberíamos apoyar más en los foros para alimentar la documentación ... no sólo por que ahí se encuentran las repuestas sino también las PREGUNTAS. Después de estar un tiempo revisando los posts he notado que hay varios problemas los cuales no son fáciles, y que por lo tanto yo creo que son a los que deberíamos apuntarle en los tutoriales.
me parece magnifica la idea
me parece magnifica la idea de reinamora.. ya que no sería en teoria nada complejo, solo sería una recomendación de módulos para usar en caso de que el usuario quiera crear un sitio de X tipo.
en dónde propones dentro de la estructura planeada que se pueda incluir esto? de entrada podría ser en Getting Started -> FAQ's -> Qué módulos usar para o en Beyond the Basics -> Qué modulos usar para..