Re: [Python-Dev] audience-instructors for Teach Me Python Bugfixing needed

2010-07-28 Thread Catherine Devlin
The PyOhio contribu-palooza starts this Saturday!
http://www.pyohio.org/Contribute With two talks and a two-day-four-night
sprint, I'm very hopeful that it will recruit and train some new core
workers.

I'm preparing my portion, the teach-the-newbie (me) -to-fix-a-core-bug
session, and I want to make sure that I'm prepared in two ways:

1. Any bulky download/compilation steps are complete

I pulled the Py3 trunk with svn co
http://svn.python.org/projects/python/branches/py3k python, did the
compilation steps, and verified that I can fire up the latest build.

I also note that http://www.python.org/dev/ doesn't say anything about hg
yet.  Is there someplace else I should look for hg-centered docs?  Should we
just teach it using svn if that's better documented?  Then again, if hg is
the way of the future...

I also built the docs (``cd Doc; make html``)

Are there other things that I need to do to configure my machine
beforehand?  Things that are too long/boring for the audience to sit through
while I do it live?

2. Have a good set of questions to ask.

Here's what I'm planning so far:

- While running ``make test`` on the Python trunk, I got an error on
test_os.  Is that a problem with my machine's configuration, or with the
build?  Do I need to report it?  Can I ignore it?

Now we'll find a bug.
- Do I need an account on bugs.python.org?  What do I need to do to get one?
- How do I find a bug suitable for me to work on?
 - entry-level
 - in Python not C
 - corresponding to my strong points / interests

Now we'll find a fake bug that David has planted for us.  (David, have you
planted it yet?)
- Can/should I make my edits directly in the trunk that I just pulled down?

- Now we'll make the fix... maybe this should involve using a debugging IDE
or pdb?
- How do I verify that my fix worked?  That it didn't break anything else?
That it's written with proper style?  That it doesn't generally suck?
- How do I send my fix back up to the trunk?
- How do I record my work in the bug tracker?

(If time permits) now let's try writing a test for a gap in test coverage
(not necessarily on the code we just worked on - this doesn't have to be
fake)

DON'T ANSWER THESE!  I need to carefully guard my sincere ignorance through
Saturday!  (Actually, I already have a pretty good idea about some of them,
but I don't want my ignorance to become any less sincere than it already
is.)  But, if you're David or Dan or anybody else who's going to be there,
you may want to ponder how you'll guide me through it.

But what I want to know from all of you is: what other questions should be
on my list?

I was going to address this only to David, my primary audience/instructor
volunteer, but I thought it wouldn't hurt to get input from the rest of you.

Thank you all!

-- 
- Catherine
http://catherinedevlin.blogspot.com/
*** PyOhio 2010 * July 31 - Aug 1 * Columbus, OH * pyohio.org ***
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] audience-instructors for Teach Me Python Bugfixing needed

2010-05-07 Thread Vincent Davis
On Thu, May 6, 2010 at 9:29 AM, Antoine Pitrou solip...@pitrou.net wrote:


 Scanning through open issues will also give you a general idea of what
 kind of functionalities are looking for improvement, or need fixing.

 (you can create a new issue and start tackling it yourself, too)

 As a wanabe Dev I think the hardest thing is to find an open issue I can
actually fix and to have a mentor to help make sure I don't miss something I
did not know about.

Please record the Teach Me session if it happens. (audio and/or video)




  *Vincent Davis
720-301-3003 *
vinc...@vincentdavis.net
 my blog http://vincentdavis.net |
LinkedInhttp://www.linkedin.com/in/vincentdavis
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] audience-instructors for Teach Me Python Bugfixing needed

2010-05-07 Thread Nick Coghlan
Vincent Davis wrote:
 As a wanabe Dev I think the hardest thing is to find an open issue I can
 actually fix and to have a mentor to help make sure I don't miss
 something I did not know about. 

Does the easy tag help with that at all? It's intended to mark issues
that aren't delving into deep dark corners of the interpreter or
standard library, but when you've been doing this for a long time one's
judgment of what's easy and what's difficult can get a little askew.

(e.g. I recently marked the task of fixing the enumerate docstring as
easy, but that does still require knowing how docstrings work for C code)

Cheers,
Nick.

-- 
Nick Coghlan   |   ncogh...@gmail.com   |   Brisbane, Australia
---
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


[Python-Dev] audience-instructors for Teach Me Python Bugfixing needed

2010-05-06 Thread Catherine Devlin
Hey, everybody... I'm Catherine, a database administrator who makes up
excuses to write Python instead.

I'm not actually here as a core developer, but as somebody who hopes to
become a developer and recruit some more, which brings me to my question:

Who lives close enough to Ohio to make it to PyOhio this summer?  I want to
use PyOhio to create new Python devs (including myself), but I need some
existing ones to seed the process.

I need a few veterans (3?) who can commit to come to PyOhio and take part as
audience/instructors in a Teach Me [Python core / standard library]
Bugfixing session.  (See
http://catherinedevlin.blogspot.com/2010/04/bugfixing-at-pyohio.html.)  The
PyOhio Call for Proposals is up May 10 so I'd better find you quick!

I'm pretty much ignorant enough to lead a Teach Me session.  In a Teach Me
session, the person at the projector *doesn't* know the material.  Instead,
she asks the audience questions (How do I find a bug to work on?), and
they talk her through it.  It's based on Teach Me Twisted, a mind-blowing
session Steve Holden led at PyCon 2008 (
http://catherinedevlin.blogspot.com/2008/03/teach-me-twisted.html).  I think
it's a fantastic way to teach, but it depends on some veterans being in the
audience.  There are folks in the greater Python community eager to get hold
of a video of such a session... if we do this well, it could become an
important tool in keeping the quality of core Python code high.

And all I need from you, my audience-instructors, is a promise to show up
(no preparation necessary).  Can you make it?  Can you pass the appeal on to
others you know of?

Thanks!  Hope to see you in July!

-- 
- Catherine
http://catherinedevlin.blogspot.com/
*** PyOhio 2010 * July 31 - Aug 1 * Columbus, OH * pyohio.org ***
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com


Re: [Python-Dev] audience-instructors for Teach Me Python Bugfixing needed

2010-05-06 Thread Doug Hellmann
What an excellent idea!  We should have these at *every* regional  
conference.


Doug

On May 6, 2010, at 10:47 AM, Catherine Devlin wrote:

Hey, everybody... I'm Catherine, a database administrator who makes  
up excuses to write Python instead.


I'm not actually here as a core developer, but as somebody who hopes  
to become a developer and recruit some more, which brings me to my  
question:


Who lives close enough to Ohio to make it to PyOhio this summer?  I  
want to use PyOhio to create new Python devs (including myself), but  
I need some existing ones to seed the process.


I need a few veterans (3?) who can commit to come to PyOhio and take  
part as audience/instructors in a Teach Me [Python core / standard  
library] Bugfixing session.  (See http://catherinedevlin.blogspot.com/2010/04/bugfixing-at-pyohio.html.) 
  The PyOhio Call for Proposals is up May 10 so I'd better find you  
quick!


I'm pretty much ignorant enough to lead a Teach Me session.  In a  
Teach Me session, the person at the projector *doesn't* know the  
material.  Instead, she asks the audience questions (How do I find  
a bug to work on?), and they talk her through it.  It's based on  
Teach Me Twisted, a mind-blowing session Steve Holden led at PyCon  
2008 (http://catherinedevlin.blogspot.com/2008/03/teach-me-twisted.html 
).  I think it's a fantastic way to teach, but it depends on some  
veterans being in the audience.  There are folks in the greater  
Python community eager to get hold of a video of such a session...  
if we do this well, it could become an important tool in keeping the  
quality of core Python code high.


And all I need from you, my audience-instructors, is a promise to  
show up (no preparation necessary).  Can you make it?  Can you pass  
the appeal on to others you know of?


Thanks!  Hope to see you in July!

--
- Catherine
http://catherinedevlin.blogspot.com/
*** PyOhio 2010 * July 31 - Aug 1 * Columbus, OH * pyohio.org ***
___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/doug.hellmann%40gmail.com


___
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com