It's easy to annotate code using modern interactive tools, and even easier to share these annotations with other people. Plus, modern tools also let you inspect the code, analyze usage, etc.