<html><head><meta http-equiv="Content-Type" content="text/html charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div>On Jun 6, 2015, at 10:14 PM, Tom Viner <<a href="mailto:tom@viner.tv">tom@viner.tv</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">Quite right Steve. Teams may like to tidy up their code and create an issue on Dan (lordmauve)'s bitbucket repo. The raspberry pi foundation will then have a chance to use your code in lesson plans for kids round the country.</blockquote></div><br><div><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "></div></div></div></div><br><div>Along those lines, I realized as I was tidying up that while the code is self-evident to me, and to any experienced programmer, it would probably be very helpful to our junior colleagues (a phrase I try to use in preference to "kids" or even "students" as being more inclusive) if we were to add simple comments.<div><br></div><div>In my README I also put a short description of the program's architecture and operation, along with hints for enhancements students might like to make. I left the program functional but deliberately incomplete, and some of the enhancements (e.g. add sound, improve the graphics) are easy enough for even non-programmers to undertake without dread. That's an easy way to get a sense of accomplishment.</div><div><br></div><div>I'm currently busy adding branches to show my approach to some of these enhancements, which I hope will be useful to teachers who aren't particularly experienced programmers themselves in helping students who undertake them.</div><div><br></div><div>I think it's perhaps as complex as it needs to get now, otherwise it will start to need a Teacher's Guide :-)</div><div><br></div><div>S</div><div><br><div><div>-- </div></div><div apple-content-edited="true"><div style="color: rgb(0, 0, 0); font-family: Courier; font-size: medium; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="color: rgb(0, 0, 0); font-family: Courier; font-size: medium; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="color: rgb(0, 0, 0); font-family: Courier; font-size: medium; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="color: rgb(0, 0, 0); font-family: Courier; font-size: medium; font-style: normal; font-variant: normal; font-weight: normal; letter-spacing: normal; line-height: normal; orphans: 2; text-align: -webkit-auto; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div apple-content-edited="true"><div style="margin: 0px; font-size: 12px; ">Steve Holden <a href="mailto:steve@holdenweb.com">steve@holdenweb.com</a> / +1 571 484 6266 / +44 208 289 6308 / @holdenweb</div></div></div></div><br class="Apple-interchange-newline"></div><br class="Apple-interchange-newline"></div><br class="Apple-interchange-newline"><br class="Apple-interchange-newline">
</div>
<br></div></div></body></html>