On 2015-12-05 5:44 PM, Adam McGreggor wrote:
Since
we get a lot of GSoC student aspirants and folk who meet one of us
and think "these seem like nice people, maybe I'll make my first
open source contribution with them,"  I think there's good reason to
have something a bit more extensive than the existing CONTRIBUTE
stuff.

I imagine there's content that's available already, too, for My First
Project, for some reason, I'm thinking it's the sort of thing Mozilla
will have done a fair few iterations on (and will be nicely licensed).

Yes, such content exists, and we can link to some of it, but it's typically too general for a beginner who doesn't yet know how to handle that. I spend literally hundreds of hours a year talking to students about where they get stuck as new contributors as part of my role as the Python GSoC coordinator, plus I hang out in the OpenHatch channel (they're one of many orgs that works to make the "how do i get started?" docs better) and I hear the "I got this far but then there were no architecture docs and I got overwhelmed" and variants on it a lot.

We need those architecture docs and that bridging stuff that goes from "how to github" to "what does mailman want in a pull request and how many tests do I need to include if I want to make Barry happy?"

It's a moot point to argue about it, anyhow. Either I write this now for the website or I write it 40 times on IRC in February while the students complain that I'm not answering them fast enough, and I know which one I'd prefer! ;)

 Terri


_______________________________________________
Mailman-Developers mailing list
Mailman-Developers@python.org
https://mail.python.org/mailman/listinfo/mailman-developers
Mailman FAQ: http://wiki.list.org/x/AgA3
Searchable Archives: 
http://www.mail-archive.com/mailman-developers%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-developers/archive%40jab.org

Security Policy: http://wiki.list.org/x/QIA9

Reply via email to