Category Archives: Programming
Change history in code comments considered harmful
I really dislike seeing code comments that say // Changed by X on date Y for bug Z start … // Changed by X on date Y for bug Z end That is what revision control is for. Use commit … Continue reading
Choose your package carefully
I don’t know what the situation was back when the project started, but if you now look at the DITA-OT Java package org.dita.dost, it makes you think why didn’t they choose something else. The package org.dita looks correct, but if … Continue reading
DITA-OT version numbers
I’ve never been a fan of the way DITA-OT versions its releases. When I see a version number 1.5.2, I assume the numbering scheme is major.minor.micro, i.e. it’s the second bug release to version 1.5. DITA-OT, however, uses a scheme … Continue reading
Ant RELAX NG schema
I use oXygen to edit Ant build files and it uses a DTD for the schema. While that works well, the DTD has a few bugs and AFAICT does not support Ant 1.7. So, I wrote a RELAX NG schema … Continue reading
Normalized DITA 1.1 DTD
The DITA DTD files are highly modularized and while most XML processors have no problems dealing with nested parameter entities, in production environments this may introduce redundant complexity. In addition, because of the way DTD files are build, topic specializations … Continue reading