<div dir="ltr"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div>I've just read and article which makes a good case for providing pre-conditions and post-conditions.</div><div class="gmail_extra"><br></div><div class="gmail_extra"><span style="font-size:small;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline"><a href="http://pgbovine.net/python-unreadable.htm">http://pgbovine.net/python-unreadable.htm</a></span><br><div class="gmail_quote"><br></div><div class="gmail_quote">The main point is: "without proper comments and documentation, even the cleanest Python code is incomprehensible 'in-the-large'." I find the article to be thoughtful and well-written.</div><div class="gmail_quote"><br></div><div class="gmail_quote">By the way the author, Philip J Guo, is also the author of</div><div class="gmail_quote">Â </div><div class="gmail_quote">Â Â <a href="http://pgbovine.net/publications/non-native-english-speakers-learning-programming_CHI-2018.pdf">http://pgbovine.net/publications/non-native-english-speakers-learning-programming_CHI-2018.pdf</a><br></div><div class="gmail_quote">Â Â Â <a href="http://pythontutor.com/">http://pythontutor.com/</a></div><div class="gmail_quote"><br></div><div class="gmail_quote">I recommend all of the above.</div><div class="gmail_quote"><br></div><div class="gmail_quote">--Â </div><div class="gmail_quote">Jonathan</div></div></div></div></div></div>