<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Dear Carrie Anne and Amit<div class=""><br class=""></div><div class="">I too have been concerned about the Python documentation being too difficult for students to understand.</div><div class=""><br class=""></div><div class="">To be easy to teach, navigate and to link to in IDEs, the documentation requires a clear and logical structure.</div><div class=""><br class=""></div><div class="">To be easily understandable and accessible to youngsters, the language in the documentation needs to be concise and clear and with a consistent style. This means, in my mind, that although it can be a community endeavour, it needs an agreed structure first and a good copy-editor at the end.</div><div class=""><br class=""></div><div class="">To see what this would involve I have had a go and discovered it will be a big job. Well worth sharing!</div><div class="">I have experimented with a straight html structure but I have no idea if this is the best way of doing this to make it easy to incorporate in IDEs. I suspect XML would be better.</div><div class=""><br class=""></div><div class="">I have produced a nested index system with plain english descriptions provided all the way through but ending in a single page with a logical name that could be used in IDEs. So, for example, the random.choice() function has its own page with the same headings as other functions and is accessed by navigating through built-in modules then random (which has its own description) then then clicking on the choice() link which has its own description.</div><div class=""><br class=""></div><div class="">I have not explored classes and their corresponding methods provided by modules built this way because I think it is pretty easy to see how these can follow the same system.</div><div class=""><br class=""></div><div class="">Anyway, have a look and see what you think: <a href="http://codingclub.co.uk/EdDoc/" class="">http://codingclub.co.uk/EdDoc/</a></div><div class="">(I have used an obvious link style so you can clearly see where I have provided examples. This is not a comprehensive Documentation set!!)</div><div class=""><br class=""></div><div class="">Best wishes</div><div class="">Chris</div><div class=""><br class=""><div><blockquote type="cite" class=""><div class="">On 13 Jul 2016, at 07:32, Carrie Anne Philbin <<a href="mailto:carrieanne@raspberrypi.org" class="">carrieanne@raspberrypi.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class="">This is a great blog by a teacher in Bath who I believe is on this mailing list. I'm sure she can give you a list, but to start with here is <a href="https://codeboom.wordpress.com/2016/05/11/scratch-is-the-new-powerpoint/" class="">the post</a> I was referring to. <div class=""><br class=""></div><div class="">I hope some teachers will read this and add their requests for good documentation so your offer of help gets snapped up! As Nicholas mentioned, a Python in education website is being formulated. We will need good documentation for it. More details to come!</div><div class=""><br class=""></div><div class="">Thanks,</div><div class=""><br class=""></div><div class="">Carrie Anne.</div></div><div class="gmail_extra"><br class=""><div class="gmail_quote">On Wed, Jul 13, 2016 at 5:12 AM, Amit Saha <span dir="ltr" class=""><<a href="mailto:amitsaha.in@gmail.com" target="_blank" class="">amitsaha.in@gmail.com</a>></span> wrote:<br class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On Wed, Jul 13, 2016 at 3:52 AM, Carrie Anne Philbin<br class="">
<<a href="mailto:carrieanne@raspberrypi.org" class="">carrieanne@raspberrypi.org</a>> wrote:<br class="">
> I've been distracted lately by all of the work that the micro-python group<br class="">
> have been doing to support the BBC micro:bit. Work that continues and needs<br class="">
> your support.<br class="">
><br class="">
> 1. Work is continuing on Mu the learner focused Python IDE. The team would<br class="">
> really appreciate your thoughts and feedback, especially if you work with<br class="">
> young people or those new to Python. You can do so here, on another thread<br class="">
> or on the Microbit-Python mailing list.<br class="">
><br class="">
> 2. Support for teachers/learners. If you need support learning python or<br class="">
> teaching with python then why not start a thread here? A wonderful Python<br class="">
> community person will help you out. This is a really quick and simply way<br class="">
> that members can get involved. They want to help you!<br class="">
><br class="">
> 3. Lesson plans, tutorials/resources. Have you written any that you want to<br class="">
> share with others? Then share them here with a new thread. Spread the love!<br class="">
><br class="">
> 4. Documentation. Recently CodeBoom wrote a really good blog post about the<br class="">
> lack of good documentation for python modules that are used in education.<br class="">
> Could educators on this list, collate their most used modules that need<br class="">
> documenting for those wanting to get started with them. Could others help<br class="">
> with this?<br class="">
<br class="">
</span>I would be keen to help with the documentation. Can you please point<br class="">
to the post you are referring to?<br class="">
<span class=""><br class="">
<br class="">
<br class="">
><br class="">
> 5. Education bundle. Dan Pope started a thread sharing his progress on this.<br class="">
> Can you provide feedback, ideas, suggestions, a pat on the back, testing<br class="">
> opportunities in the future?<br class="">
<br class="">
</span>I am looking forward to help with the edu bundle too.<br class="">
<span class="im HOEnZb"><br class="">
<br class="">
<br class="">
><br class="">
> The moral here is do not let this WG die! Everyone always asks me "how can I<br class="">
> get involved?" Educators share your success, failures and frustrations.<br class="">
> Community members share your ideas, solutions and good-will.<br class="">
><br class="">
> Thanks,<br class="">
><br class="">
> Carrie Anne.<br class="">
><br class="">
> --<br class="">
> Director of Education<br class="">
> Raspberry Pi Foundation<br class="">
> UK Charity No. 1129409<br class="">
><br class="">
> <a href="http://www.raspberrypi.org/" rel="noreferrer" target="_blank" class="">www.raspberrypi.org</a> | <a href="http://www.codeclub.org.uk/" rel="noreferrer" target="_blank" class="">www.codeclub.org.uk</a><br class="">
> @ | in | ▷<br class="">
><br class="">
><br class="">
><br class="">
</span><div class="HOEnZb"><div class="h5">> _______________________________________________<br class="">
> Pythonedu-wg mailing list<br class="">
> <a href="mailto:Pythonedu-wg@python.org" class="">Pythonedu-wg@python.org</a><br class="">
> <a href="https://mail.python.org/mailman/listinfo/pythonedu-wg" rel="noreferrer" target="_blank" class="">https://mail.python.org/mailman/listinfo/pythonedu-wg</a><br class="">
><br class="">
<br class="">
<br class="">
<br class="">
</div></div><span class="HOEnZb"><font color="#888888" class="">--<br class="">
<a href="http://echorand.me/" rel="noreferrer" target="_blank" class="">http://echorand.me</a><br class="">
</font></span></blockquote></div><br class=""><br clear="all" class=""><div class=""><br class=""></div>-- <br class=""><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class="">Director of Education</div><div dir="ltr" class="">Raspberry Pi Foundation</div><div dir="ltr" class=""><span style="font-size: 12.8px;" class="">UK Charity No. 1129409</span></div><div dir="ltr" class=""><span style="font-size: 12.8px;" class=""><br class=""></span></div><div dir="ltr" class=""><span class=""><div style="font-size:12.8px" class=""><a href="http://www.raspberrypi.org/" style="color:rgb(17,85,204);font-size:12.8px" target="_blank" class="">www.raspberrypi.org</a><span style="font-size:12.8px" class=""> </span><span style="font-size:12.8px" class="">| <a href="http://www.codeclub.org.uk/" target="_blank" class="">www.codeclub.org.uk</a></span></div><div style="font-size:12.8px" class=""><a href="http://twitter.com/missphilbin" style="color:rgb(17,85,204)" target="_blank" class="">@</a><span style="font-size:12.8px" class=""> | <a href="https://uk.linkedin.com/in/carrie-anne-philbin-a20649b7" style="color:rgb(17,85,204)" target="_blank" class="">in</a> | </span><a href="https://www.youtube.com/user/GeekGurlDiaries" style="color:rgb(17,85,204);font-size:x-small;font-family:arial" target="_blank" class=""><b class="">▷</b></a><br class=""></div><font class=""><br class=""><br class=""></font></span></div></div></div></div></div></div>
</div>
_______________________________________________<br class="">Pythonedu-wg mailing list<br class=""><a href="mailto:Pythonedu-wg@python.org" class="">Pythonedu-wg@python.org</a><br class="">https://mail.python.org/mailman/listinfo/pythonedu-wg<br class=""></div></blockquote></div><br class=""></div></body></html>