- Software Developer, Technical Writer
Customers chose Cloud Pak for Data services from a product catalog, which was nicely designed with the IBM Carbon Design System. Each service in the catalog linked to a landing page in the documentation, which provided more information about the service.
Content strategists worked with the design team and me to come up with a design layout for the landing pages that nicely transitions from the design experience of the catalog to that of the documentation system.
Two years later, all content built through the standard build process for IBM Docs was translated automatically with machine translation. To take advantage of this, I rewrote the pages in DITA with extensive conkeyref reuse and a custom DITA XSLT override, supported in the build. It’s arguable which method is easier to maintain, YAML or DITA, but the content strategists were satisfied with the change regardless.