Thanks for all replies and the good advice. Grafoscopio looks impressive and very interesting! After working more and more with Pharo I see and understand the approach to documentation better I think. So my next steps will be finishing the application I'm writing and documenting that, also if I see class comments that are hard to understand I will report them, maybe even try to improve them myself. I'm thinking a lot about how to improve the programming experience and one thing I came up with was, that maybe showing the comment of a message while having the autocompletion dialog open or when selecting it in the code editor would help to grasp the frameworks faster. Since I still don't know much about the whole system: would that be hard to implement? Best, Julius -- View this message in context: http://forum.world.st/Essential-Documentation-tp4916861p4917224.html Sent from the Pharo Smalltalk Users mailing list archive at Nabble.com.