Dita

Esta historia ocurrió a mediados de 2023. Finalmente, encontré el tiempo suficiente para escribir al respecto. Convertir Markdown a DITA manualmente no es divertido Solía trabajar para una empresa que utilizaba DITA XML para su documentación. Por razones que no puedo discutir debido a acuerdos de confidencialidad (NDA), un puñado de sus productos usaban Markdown (MkDocs) para su documentación en lugar de DITA. Ejecutar ambos sistemas en paralelo parecía funcionar bien al principio. Sin embargo, eventualmente causó problemas cuando comenzamos a integrar esos productos con el resto de nuestro portafolio, que usaba DITA para la documentación. Necesitábamos reutilizar contenido y mantenerlo sincronizado, lo que significaba recrear casi todo manualmente. Después de unas semanas de copiar y pegar contenido manualmente, mi gerente decidió que debíamos migrar todo a DITA XML. ...

This story happened in mid-2023. I finally found enough free time to write about it. Manually converting Markdown to DITA isn’t fun I used to work for a company that used DITA XML for its documentation. For reasons I cannot discuss due to NDAs, a few of their products used Markdown (MkDocs) for their documentation instead of DITA. Running both systems in parallel seemed fine at first. However, it eventually caused problems when we started integrating those products with the rest of our portfolio, which used DITA for documentation. We needed to reuse content and keep it synchronized, which meant manually recreating most things. After a few weeks of manually copy-pasting content, my manager decided we should migrate everything to DITA XML. ...

To see my tech writing portfolio, click here.