Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
como_redactar_documentacion_diy [2010/09/16 21:30]
juanluis
como_redactar_documentacion_diy [2012/02/01 15:45] (actual)
Línea 1: Línea 1:
-@Lino: diría que la confusión que comentas empeora en españa porque las élites decisoras y mandantes están particularmente mal situadas en el lado malo de la brecha digital, y por lo tanto no pueden valorar desde la experiencia personal lo que significarían políticas eficaces para cambiar eso. Ellos no usan ningún medio de colaboración online, porque para eso está la secretaria, que el blog o incluso el email degradan si los tocas en directo. Te sorprenderías de las edades de estos preclaros líderes, y no sólo zapatero :D. 
- 
-La sobrecarga de información creo que sólo se puede vencer con medios sociales, smartcrowding o como quieras llamarlo. EL esfuerzo colectivo organiza cualquier fuente de información de forma que no puede ni el individuo ni la más lista de las máquinas. Ejemplo: un foro popular sobre cualquier tema, te tiene al día de conocimiento útil y lo más probable es que el conocimiento práctico para que la cosa funcione esté ahí. 
- 
-A partir de ahi, la vejez y la nieve en pelo y barba hablan: es necesaria la lectura lenta, bajar el ritmo, aumentar la concentración y no querer resultados de hoy para mañana. La mente da para lo que da. 
- 
-Como fan de la cifi que eres, lo mismo has leido "Naufragio en el tiempo real" de Vernon Vinge. Cuando la prota baja a la tierra, descubre que no dispone de sus medios de gestión del conocimiento, sino que tiene que recurrir a... libros. A leerlos, a la lentitud del caracol del lenguaje escrito. Da que pensar :) 
- 
 ====== Documentación DIY ====== ====== Documentación DIY ======
  
 ===== Importancia de la documentación ===== ===== Importancia de la documentación =====
  
-La documentación es el núcleo de un [[que_es_discadiy#discadiy1|discadiy]]: son las instrucciones que van a permitir a otros montar y construir nuestra solución y poder utilizarla+La documentación es el núcleo de un [[todo_sobre_eddiy:Internet_y_eddiy#discadiy1|discadiy]]: son las instrucciones que van a permitir a otros montar y construir nuestra solución y poder utilizarla
 ===== Buenas prácticas en la generación de documentación ===== ===== Buenas prácticas en la generación de documentación =====
  
Línea 17: Línea 9:
     * El objetivo es que se beneficie el máximo número de personas y familias posibles. No temas nunca a explicar algo demasiado sencillo u obvio. Más vale una explicación de más que de menos en este caso.     * El objetivo es que se beneficie el máximo número de personas y familias posibles. No temas nunca a explicar algo demasiado sencillo u obvio. Más vale una explicación de más que de menos en este caso.
     * El **orden es esencial**. Si el lector no tiene dificultades con la lógica y el sentido de lo que le explicas en tu manual, avanzará más rápido.     * El **orden es esencial**. Si el lector no tiene dificultades con la lógica y el sentido de lo que le explicas en tu manual, avanzará más rápido.
-    * No está de más que recuerdes que, cuanto más económico sea un discadiyva a ser accesible a un mayor número de personas. +    * No está de más que recuerdes que un discadiy, cuanto más económico, será accesible a un mayor número de personas. 
     De igual manera, si haces referencia a dónde se pueden encontrar los componentes y piezas que pueden hacer falta para tu discadiy, ayudarás a tus lectores a superar una barrera más - que, en ocasiones, puede llegar a ser importante.     De igual manera, si haces referencia a dónde se pueden encontrar los componentes y piezas que pueden hacer falta para tu discadiy, ayudarás a tus lectores a superar una barrera más - que, en ocasiones, puede llegar a ser importante.
-  * Una imagen vale más que mil palabras, y otro tanto le sucede al video respecto a la imagen. Las fotos y esquemas de las etapas de tu discadiy pueden servir para sortear barreras, y podrás subirlas sin problemas al servidor que aloja [[http://emadrid2011.es/discadiy/doku.php|DiscaDIY]]. Te hemos dejado unas instrucciones [[instrucciones_de_dokuwiki#subir_imagenes|aquí]]. En lo que al video se refiere, bastará con que sigas [[instrucciones_de_dokuwiki#embeber_un_video|estas instrucciones]] +  * Una imagen vale más que mil palabras, y otro tanto le sucede al video respecto a la imagen. Las fotos y esquemas de las etapas de tu discadiy pueden servir para sortear barreras, y podrás subirlas sin problemas al servidor que aloja [[http://emadrid2011.es/discadiy/doku.php|DiscaDIY]]. Te hemos dejado unas instrucciones [[todo_sobre_eddiy:Internet_y_eddiy#subir_imagenes|aquí]]. En lo que al video se refiere, bastará con que sigas [[todo_sobre_eddiy:Internet_y_eddiy#embeber_un_video|estas instrucciones]] 
-  * En la medida en la que te sea posible, el diálogo con los usuarios de tu discadiy puede acabar de redondearlo. Pásate de vez en cuando para ver los comentarios y suscríbete a los cambios pulsando en ''Suscríbete a los cambios de la página'' en la parte inferior de la pantalla +  * En la medida en la que te sea posible, el diálogo con los usuarios de tu discadiy puede acabar de redondearlo. Pásate de vez en cuando para ver los comentarios y suscríbete a los cambios pulsando en ''Suscríbete a los cambios de la página'' en la parte inferior de la pantalla.
como_redactar_documentacion_diy.1284665419.txt.gz · Última modificación: 2010/09/30 13:12 (editor externo)
CC Attribution-Share Alike 4.0 International
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0