¿Algún consejo sobre cómo aprender DITA para redacción técnica?

No sé cuánto beneficio obtendrá en un currículum por haber leído, en lugar de haber usado , DITA, pero algo de conocimiento es mejor que nada.

DITA es tanto un marco específico como un enfoque. Mi grupo de documentación está trabajando actualmente en el libro DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA de Laura Bellamy, Michelle Carey y Jenifer Schlotfeldt y hasta ahora lo consideramos una buena introducción. No planeamos migrar al marco DITA , pero hemos estado tratando de aplicar un enfoque similar por nuestra cuenta y estamos encontrando que el libro es útil para señalar problemas en los que no necesariamente hemos pensado lo suficiente. El libro también contiene mucha información específica para el marco, por lo que debería ser aún más útil para alguien que está apostando por DITA.

El libro tiene menos de 300 páginas y no es demasiado denso, por lo que debería poder absorberlo en menos de una semana.

No sé si será demasiado tarde, pero aún así, aquí hay una herramienta gratuita que encontré para aprender DITA:

http://www.learningdita.com/

Actualmente sigo el curso, aunque me ha bajado un poco el todo. Ya estoy familiarizado con la mayor parte del contenido por mis propias lecturas y, desde esa perspectiva, diré que es muy completo y completo.

Aunque ya tengo las ideas básicas, recomendaría esto para principiantes, definitivamente comienza de manera simple.

Aquí está la guía de estilo completa que explica en detalle cómo usar cada elemento si se sumerge y lo prueba:

https://www.oxygenxml.com/dita/styleguide/webhelp-feedback/index.html

Para una introducción más práctica, puede considerar descargar e instalar DITA Open Toolkit . Una vez que haya configurado el kit de herramientas, puede:

1. Eche un vistazo a la fuente XML de DITA para una publicación real, a saber, la guía del usuario de DITA Open Toolkit. La fuente se encuentra en la carpeta docsrc, pero también puede acceder a ella en GitHub .
2. Utilice esta fuente para crear el resultado final, por ejemplo, HTML o PDF. Para ello, consulte Reconstruir la documentación de DITA-OT (o el Capítulo 20 en la versión PDF).
3. Abra un archivo de tema .dita. Intente encontrar ese tema en el documento buscando su título. Observe cómo el XML sigue una estructura de tema específica . En DITA, un tema es la unidad básica de creación .
4. Abra un archivo .ditamap y compare lo que ve con la tabla de contenido de esta publicación. Observe cómo utiliza los elementos del mapa DITA para organizar una serie de temas.
5. Realice un pequeño cambio en el título de un tema (quizás después de hacer una copia de seguridad) y reconstruya la publicación. Observe cómo su cambio se incluye en la nueva versión del documento.
6. En este punto, se dará cuenta de que podría ser todo un desafío escribir un documento en DITA sin alguna herramienta adicional de soporte. Aquí es donde entran las herramientas "conscientes de DITA" como Oxygen XML Author para brindar soporte de edición. Tenga en cuenta que Oxygen viene incluido con DITA Open Toolkit. Hay una lista de herramientas que utilizan DITA Open Toolkit en dita-ot.org . Consulte también esta lista de herramientas de software relacionadas con DITA .

La sección 2.2.1.2 del estándar Oasis de la Arquitectura de escritura de información de Darwin (DITA) contiene más información sobre los beneficios de la autoría basada en temas.

Para obtener más ejemplos de creación basada en DITA, consulte la lista de colecciones DITA de código abierto en oasis-open.org.