Yo y varios otros miembros de JMP Recientemente asistí a Minimalismo Taller para escritores y editores presentado por Servicios ComTech . El taller se centró en reducir la cantidad de contenido escrito que puede ser demasiado grande o detallado sin afectar la calidad.
El minimalismo, concebido por John M. Carroll en el Watson Research Center de IBM, se centra en el aprendizaje basado en texto que fomenta la exploración en lugar del aprendizaje de roles. La teoría minimalista propone animar a los usuarios de inmediato, minimizar la lectura y hacer que llenen los vacíos. Por lo tanto, documentación minimalista A menudo contiene procedimientos con poca o ninguna introducción y explicación. La idea es incluir contenido que esté orientado a la acción, sea útil y se adapte bien a la tarea. El minimalismo pone el contenido más importante a la vanguardia y minimiza las distracciones para el usuario.
Los cuatro principios principales son:
• Incorporar un enfoque orientado a la acción - Aprender haciendo
• Centrarse en los objetivos reales de los usuarios: tareas reales de soporte
• Admite reconocimiento y recuperación de errores: aprende de los errores
• Acceso a la información de soporte: localice la información rápidamente
Discutimos cada principio en clase y revisamos una lista de verificación para asegurarnos de que estábamos incorporando el principio en el contenido. Nos complació descubrir que ya hemos aplicado varios aspectos de cada principio en la documentación de JMP con la iniciativa de refactorización que comenzó con la Guía de Análisis Básico y Gráficos en la versión 9.
Un área que necesitamos desarrollar, sin embargo, es nuestro análisis de audiencia. Para incorporar un enfoque más centrado en el usuario, necesitamos aprender más sobre nuestros clientes y realizar análisis de usuarios y tareas. Necesitamos definir a nuestros usuarios, priorizar sus necesidades y decidir a quién escribir. Sin esa comprensión, el minimalismo degenera en solo hacer oraciones más cortas o eliminar secciones en la documentación que nadie lee.
Los minimalistas entienden que las personas no leen nada que no parece llevar a cumplir sus objetivos inmediatos. De hecho, cuanto más corto y delgado sea el texto, más probable es que la gente lo lea. Un enfoque minimalista conduce a ahorros en el tiempo y el esfuerzo utilizado para producir, administrar, editar, actualizar, corregir, revisar, publicar y administrar el contenido. Esto también ayuda a eliminar posibles problemas con la traducción y simplifica el mensaje, lo que resulta en un ahorro en los costos de traducción.
La agenda minimalista se centra en la utilidad y la usabilidad. Nuestro objetivo es escribir contenido sucinto y orientado a la acción que permita a los usuarios comprender rápidamente lo que necesitan saber y hacerlo con éxito. Siéntase libre de proporcionar comentarios a medida que continuamos aplicando un enfoque minimalista a nuestro contenido.
