Monthly Archives: November 2010

Change history in code comments considered harmful

Posted on November 20, 2010 by Jarno Elovirta

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 →

Posted in Programming | Tagged | Leave a comment

Choose your package carefully

Posted on November 19, 2010 by Jarno Elovirta

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 →

Posted in DITA | Tagged | Leave a comment

DITA-OT version numbers

Posted on November 10, 2010 by Jarno Elovirta

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 →

Posted in DITA | Tagged | Leave a comment