idiomatic-comments.md | code guide | Just for the record, how I like to comment my CSS, JavaScript and PHP, and similarly my HTML with consistent characteristics and structure, to maintain consistency, good communication and easy maintenance across languages.