[dionian]

sounds like a recipe for over-commenting. The code should be self-documenting. Comments are for the places where there are dragons.