Yes! Rendered markdown comments - especially with mermaid or equivalent diagram support and the ability to link to functions/classes/etc - directly in the IDE would be amazing!