Xml

Esta historia ocurrió a mediados de 2023. Finalmente encontré el tiempo libre suficiente para escribir al respecto. Convertir manualmente de Markdown a DITA no es divertido Solía trabajar para una empresa tecnológica que utilizaba DITA XML para su documentación. Por razones que no puedo discutir debido a acuerdos de confidencialidad (NDA), alrededor de cinco productos usaban MkDocs para su documentación en lugar de DITA. Ejecutar ambos sistemas en paralelo parecía estar bien al principio. Sin embargo, eventualmente causó problemas cuando empezamos a integrar esos productos con el resto de nuestro portafolio, que utilizaba DITA para la documentación. Necesitábamos reutilizar contenido y mantenerlo sincronizado, lo que significaba recrear manualmente la mayoría de las cosas. 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 tech company that used DITA XML for its documentation. For reasons I cannot discuss due to NDAs, about five products used 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. ...