Primacy of code

Some extremists would say that the source should be the only place to look when I need to understand a system. No secondary sources allowed.

NLP and other approaches to understand how humans interpret the world around them point to the fact that people have different preferences for learning:

Some like to read.
Some like to have things explained to them.
Some like to view pictures.
Some like to engage in discussion.
Some like to experiment and learn through feedback.
Some like mixtures of the above.

Some need more than one go at experiencing something before they understand it.
Some need things in small chunks.

Maybe primacy of code discriminates against those who don't learn well through textual readings.

I'd like to see as a start an IDE where I can put visual comments (better still, in a way that lets it create an animated slide show) rather than just text. The IDE would place an XML description in the comment (or maybe a link to a seperate image file ) so that the compiler wouldn't barf and then render it accordingly. Ideally there would be an ALT tag and the IDE could do 'Save as Text...' and the commnets would just be the content of the ALT tag.