One recurring issue we've noticed is with invalid alt text. In DITA, alt text is represented as a tag <alt>. However, during publishing, this gets converted to the HTML representation of alt text, which is an alt="..." attribute. As a result, the content editors are able to enter values in the alt text in DITA that later become invalid in HTML, and there does not seem to be any mechanism in place to disallow this.
Two such examples are:
- Writing <i> tags within alt text in DITA. (e.g. <alt>here is a <i>sample</i> invalid alt text in DITA</alt>)
- Writing double quote characters inside alt text in DITA (e.g. <alt>this is "sample" alt text</alt>)