¿Cuáles son las tendencias actuales y futuras en la documentación técnica?

Tendencia actual : Darwin Information Typing Architecture (DITA)
Creo firmemente que las filosofías detrás de DITA continuarán siendo la tendencia, es decir, una tendencia en el futuro .

¿Herramientas que usará un escritor? Algo que hace que los escritores creen y archiven documentación en el formato .XML. Para que las personas puedan construir .XML en un analizador de PDF / Doc / otro formato y representar sus datos cuando y como quieran.

Los escritores se centrarán en crear un tipo de documento individual que sea independiente en sí mismo y pueda usarse como un pensamiento único.
Los clientes querrían documentación personalizada para sus necesidades actuales. En eso, no querrían una “Guía de configuración” genérica, sino una “Guía de configuración personalizada”. Esencialmente, los escritores deberían poder hacer que la documentación sea muy específica para las necesidades del cliente.

Una cosa más, el enfoque en la consistencia del lenguaje está matando el trabajo de un escritor técnico. La investigación ha demostrado que los clientes ven la documentación como una ayuda de último recurso y que la usan para simplemente hacer su trabajo; por lo tanto, la documentación es un material de referencia que los clientes usan de manera no lineal. Por lo tanto, tener la consistencia del lenguaje es un trabajo ingrato, muy bien podemos tener una solución para esto en el futuro.

Y, los escritores impactarían fuertemente la experiencia del Usuario al opinar no solo sobre las etiquetas de la IU sino también sobre el diseño de la IU. La primera capa de experiencia del usuario se incluirá en el rol de escritor técnico.

La tendencia que veo más frecuente es “más por menos”, a menudo mucho más por mucho menos.

Por alguna razón (y creo que hay algunos que se alimentan de esto), ese será el caso durante algún tiempo.

¿Cómo conseguir más?

Definamos “más” como más contenido para menos escritores técnicos. Para que eso funcione, los escritores técnicos deben aprovechar otros contribuyentes, como expertos en la materia y miembros de la comunidad. Para tener éxito en eso, los escritores técnicos comenzarán a parecerse más a los evangelistas técnicos y requerirán más experiencia en el tema.

La tubería de producción también tendrá que verse diferente.

La estructurada “línea de producción de contenido” del pasado se desvanecerá lentamente en todas las operaciones, excepto en las más grandes. Las líneas de producción de contenido se prestan a relativamente pocos escritores que sirven a una audiencia comparativamente más grande. Apoyar a un gran grupo de contribuyentes informales requiere un proceso más distribuido (el modelo GitHub / Open-Source o el modelo Wikipedia está más cerca). Por lo tanto, los sistemas de autoría y publicación van a cambiar.

Finalmente, se necesitan métricas significativas.

Los recursos de comunicación técnica necesitarán demostrar cada vez más su valor para la organización. Las métricas para evaluar el valor del contenido de autoayuda de manera significativa han sido esquivas e inconsistentes. Los comunicadores técnicos exitosos del presente y del futuro podrán demostrar su valor utilizando métricas que se relacionan directamente con el valor comercial. Aquellos que no puedan hacer eso serán eliminados.

Esta es una pregunta interesante. Actualmente, las nubes parecen tener el lado positivo, por así decirlo. Y, anticipo que el futuro pertenecerá a comunicadores técnicos. Escribí una publicación de blog sobre un tema similar hace algún tiempo (Tendencias en comunicación técnica)

Para mí, las siguientes son las tendencias actuales:

  • Un comunicador técnico para todos: desde documentación técnica hasta material de marketing, desde herramientas (Adobe FrameMaker, MadCap Flare, Help & Manual, Adobe RoboHelp, Microsoft Office Suite, Confluence, JIRA y muchos más) hasta la metodología (DITA / XML y Agile)
  • Concéntrese en fusionar las habilidades de escritura con el desarrollo de productos para mejorar la experiencia del usuario (UX)
  • Localización y traducción de contenido más barata, rápida y efectiva.

Para el futuro, veo las siguientes tendencias:

  • Un ecosistema de información simple, comprensible, utilizable e interconectada.
  • Un usuario sabio que sabe qué información quiere y dónde la obtendrá (Sí, me atrevo a soñar con ella).
  • Implicación de comunicadores técnicos en Internet de las cosas (IoT), Realidad aumentada (AR) e Inteligencia artificial (AI)

La verdad es que, a pesar de las nuevas responsabilidades, capacidades, herramientas y expectativas que se cargan sobre nuestros hombros, seguiremos siendo escritores que se ocupan de desafíos / problemas tan básicos como escribir oraciones sin errores. Y no soy el único que se siente así.

En línea, flexible, portátil, propiedad del usuario, controlado por el usuario y creado parcialmente por el usuario.

Además, cree sobre la marcha. Más sobre el lado multicanal y multiplataforma. Menos palabras y verborrea, más podcast, videocast, webcast, wiki, blogs y formato de páginas de manual.

Los gráficos de ingeniería tendrán un mayor uso de SVG y, mediante el uso de XML, HTML 5.0 y Open Stack, tendrán documentación en línea en términos de ventanas emergentes y notas de clic, etc.

Sin embargo, la forma en que se crea el antiguo proceso DDLC y el proceso inherente de recopilación de conocimiento, y la creación de contenido central seguirá siendo básicamente la misma.

Las herramientas se ampliarán para ser más del tipo de licencia abierta, ya que los equipos de documentación técnica esperarán reducir el “costo de producción”, por lo que a su debido tiempo el software con licencia será menos favorecido y pasará a un modelo basado en suscripción o una estructura de pago por uso.

Las herramientas y los documentos son solo medios y productos, respectivamente, para preparar documentaciones técnicas.
Me enfocaré en las tecnologías de tendencias futuras y pegaré una imagen para explicar mi historia.


Crédito: Mejor diseño infográfico

La documentación colaborativa en línea (por ejemplo, wikis) es el futuro. Echa un vistazo a Atlassian Confluence.

Aquí está mi presentación sobre el futuro del contenido de tcworld India, febrero de 2014: El futuro del contenido