<html> <head> <style></style> </head> <body class='hmmessage'> Hi...<div style="text-indent: 0in !important; "><br style="text-indent: 0in !important; "></div><div style="text-indent: 0in !important; ">I checked my copy of the email and the formatting I put in the example was "lost" in transmission! At least, it disappears when I open the message. Strangely, it reappears when I go into the "Reply" mode. I don't know if this is a flaw in the Mac, or Safari, or Hotmail.  I hope you will be able to see a correct version so you will see what I am talking about!</div><div style="text-indent: 0in !important; "><br></div><div style="text-indent: 0in !important; ">Caryl</div><br><hr id="stopSpelling">From: cbigenho@hotmail.com<br>To: dinko.galetic@gmail.com; iaep@lists.sugarlabs.org<br>Date: Mon, 5 Jul 2010 22:22:55 -0700<br>Subject: Re: [IAEP] Feedback request for my Python tutorial<br><br> <style> .ExternalClass .ecxhmmessage P {padding:0px;} .ExternalClass body.ecxhmmessage {font-size:10pt;font-family:Verdana;} </style> Hello Dinko,<div><br></div><div>This is a nice project and I will take some time over the next week or 2 to look at it in detail.  I notice a few "typos" that I can help with and will send them along later.  However I do have a question and a couple of suggestions at this point after glancing at the download.</div><div><br></div><div>Question: Why are some sections unix files and others plain text?  What are we supposed to open the unix files on? I am using a Mac right now, but have an XO and a Windows PC available as well.  Did you mean for everything to be the same format... either unix or text?</div><div><br></div><div>Suggestion: When a term is used in a Python tutorial do not assume your reader knows what it stands for or means. Keeping a glossary of terms will help teach the reader more than simple mysterious commands.  For example the > and < signs could be explained (very young readers will not know these).  Also the term "int." I assume it stands for "integer."  If so, tell us somewhere that it does and what an integer is. If not... what does it represent? Is it just a variable that you picked? </div><div><br></div><div>Suggestion: Large blocks of text are very intimidating.  If you can break them up into smaller units (paragraphs) it will make it easier for the reader.  Actually, it could also be helpful it the code part of your example was shown as you have it and the rest be in another font it will help the reader. Like this from your Lesson 5:</div><div><br></div><div>-----------------------------------------------------------------------------------------------</div><div><br></div><div><font class="ecxApple-style-span" face="'Franklin Gothic Medium'"><span class="ecxApple-style-span" style="font-size:12pt">Example 1</span></font></div><div><br></div><div><div><font class="ecxApple-style-span" face="'Courier New'"># example start</font></div><div><font class="ecxApple-style-span" face="'Courier New'">again = True</font></div><div><font class="ecxApple-style-span" face="'Courier New'">while again == True:</font></div><div><font class="ecxApple-style-span" face="'Courier New'">    print "Please enter a number: "</font></div><div><font class="ecxApple-style-span" face="'Courier New'">    try:</font></div><div><font class="ecxApple-style-span" face="'Courier New'">        num = int(raw_input())</font></div><div><font class="ecxApple-style-span" face="'Courier New'">        again = False</font></div><div><font class="ecxApple-style-span" face="'Courier New'">    except:</font></div><div><font class="ecxApple-style-span" face="'Courier New'">        print "Error!"</font></div><div><font class="ecxApple-style-span" face="'Courier New'"><br></font></div><div><font class="ecxApple-style-span" face="'Courier New'">print "Here's my number:", num</font></div><div><font class="ecxApple-style-span" face="'Courier New'"># example end</font></div><div><font class="ecxApple-style-span" face="'Courier New'"><br></font></div><div><font class="ecxApple-style-span" face="'Courier New'"><div><font class="ecxApple-style-span" face="'Franklin Gothic Medium'"><span class="ecxApple-style-span" style="font-size:12pt">I sug</span><span class="ecxApple-style-span" style="font-size:12pt">gest you think</span><span class="ecxApple-style-span" style="font-size:12pt"> about this code before hitting enter to continue. Try to understand exactly what each line does - that's a good way to check how well you've learned from previous lessons. When you continue, you'll get a short explanation of the code so you can check if you got it right.</span></font></div><div><font class="ecxApple-style-span" face="'Franklin Gothic Medium'" size="4"><span class="ecxApple-style-span" style="font-size:16px"><br></span></font></div><div><font class="ecxApple-style-span" face="'Franklin Gothic Medium'" size="4"><span class="ecxApple-style-span" style="font-size:16px">--------------------------------------------------------------------------------------------------------------------</span></font></div><div><br></div></font></div><div>I have put the code part in <font class="ecxApple-style-span" face="'Courier New'"><span class="ecxApple-style-span" style="font-size:10pt">10pt</span></font> <span class="ecxApple-style-span" style="font-size:16px"><font class="ecxApple-style-span" face="'Courier New'"><span class="ecxApple-style-span" style="font-size:10pt">New Courier</span> </font><span class="ecxApple-style-span" style="font-size:10pt">and the rest in <font class="ecxApple-style-span" face="'Franklin Gothic Medium'"><span class="ecxApple-style-span" style="font-size:12pt">12pt Franklin Gothic.  <font class="ecxApple-style-span" face="Verdana"><span class="ecxApple-style-span" style="font-size:10pt">This sort of formatting will make things much easier for your readers.</span></font></span></font></span></span></div><div><br></div><div>I'm glad you have this project underway.  It will be very useful. When it is finished, we will need to get some people to translate it into other languages as well so OLPC users all over the world can enjoy using it.</div><div><br></div><div>Caryl (aka SweetXOGrannie)</div><div><font class="ecxApple-style-span" face="'Courier New'" size="4"><span class="ecxApple-style-span" style="font-size:16px"><br></span></font></div></div><div><br></div><div><br><br><hr id="ecxstopSpelling">From: dinko.galetic@gmail.com<br>Date: Mon, 5 Jul 2010 14:56:35 +0200<br>To: iaep@lists.sugarlabs.org<br>Subject: [IAEP] Feedback request for my Python tutorial<br><br>Hello everyone, <br><br>I'm a GSOC student working for Sugarlabs this summer. Right now I'm working on a Python tutorial for Pippy. <br>I would love to get some opinions on what I've done so far: my approach, the quality of materials etc. - all the teaching aspects you can think of.<br> I hope you can comment on at least some of the lessons I've made. It's available in my repository[1].<br><br>Thanks,<br>Dinko Galetic<br><br>[1] <a href="http://git.sugarlabs.org/projects/pippy/repos/dgaletic-gsoc2010/blobs/raw/8298e68c5a4f9add12b45531ccbb7ad67b6f7c52/Pippy-Python_lessons.tar.gz">http://git.sugarlabs.org/projects/pippy/repos/dgaletic-gsoc2010/blobs/raw/8298e68c5a4f9add12b45531ccbb7ad67b6f7c52/Pippy-Python_lessons.tar.gz</a><br> <br></div> </body> </html>