add comments and minor changes inline using XML coments