<div id="__MailbirdStyleContent" style="font-size: 10pt;font-family: Arial;color: #000000;text-align: left" dir="ltr">
                                        Hi Stef.<div class="mb_sig"></div>
                                        <div><br></div><div><span style="font-family: Arial, Helvetica, sans-serif;font-size: 13px">> But, to </span><span style="font-family: Arial, Helvetica, sans-serif;font-size: 13px">me, readability cannot come from hiding complexities away - it means</span><br style="font-family: Arial, Helvetica, sans-serif;font-size: 13px"><span style="font-family: Arial, Helvetica, sans-serif;font-size: 13px">> finding a proper vocabulary to explain them clearly, as they are and, as</span><br style="font-family: Arial, Helvetica, sans-serif;font-size: 13px"><span style="font-family: Arial, Helvetica, sans-serif;font-size: 13px">> Nicolas said, as they will bite anyway.</span><br></div><div><span style="font-family: Arial, Helvetica, sans-serif;font-size: 13px"><br></span></div><div><span style="font-family: Arial, Helvetica, sans-serif;font-size: 13px">Sure. "Leaky abstractions" (</span><span style="font-family: Arial, Helvetica, sans-serif"><span style="font-size: 13px">https://en.wikipedia.org/wiki/Leaky_abstraction) can be challenging. I just disagreed with the way you "sugarcoated" the effect of comments. Yes, you would have to explain the essential complexity for a hardly readable piece of code with a natural-language comment. Yet, it should be still considered a code smell, given that one did not yet managed to express the solution in idiomatic Smalltalk. :-) And maybe the programming language will never be able to express that essential complexity nicely because it may just not be a good fit for the problem at hand.</span></span></div><div><span style="font-family: Arial, Helvetica, sans-serif"><span style="font-size: 13px"><br></span></span></div><div><span style="font-family: Arial, Helvetica, sans-serif"><span style="font-size: 13px">Best,</span></span></div><div><span style="font-family: Arial, Helvetica, sans-serif"><span style="font-size: 13px">Marcel</span></span></div><blockquote class="history_container" type="cite" style="border-left-style: solid;border-width: 1px;margin-top: 20px;margin-left: 0px;padding-left: 10px;min-width: 500px">
                        <p style="color: #AAAAAA; margin-top: 10px;">Am 22.02.2021 17:42:03 schrieb Stéphane Rollandin <lecteur@zogotounga.net>:</p><div style="font-family:Arial,Helvetica,sans-serif">> We should be very careful with every low-level detail we burden the <br>> high-level programmer with. I find the phrase "[...] problems that users <br>> will have to learn sooner or later [...]" very problematic in the sense <br>> that it seems to "just give up" on readable, high-level abstractions <br>> altogether. Of course, one should not be too naive about this.<br><br>Maybe we do not have the same idea about what "readable" means, because <br>I do agree with you that the code must be readable in all cases. But, to <br>me, readability cannot come from hiding complexities away - it means <br>finding a proper vocabulary to explain them clearly, as they are and, as <br>Nicolas said, as they will bite anyway.<br><br>Stef<br><br></div></blockquote></div>