I like assembly too. My comment/code ratio is about 3:1, and I include the occasional soliloquy, math derivation, protocol description, and ascii-art diagram. I saw some Windows source code a while back: a simple API wound up being a score of source files, many doing nothing but passing stuff off to others under assumed names. Each did have the Microsoft-mandatory comment header. Under "Description of function:" people had filled in useful things like "what it says."
John