intro to core (python!) involvement © dan buch 2010 [email protected] ~ licensed creative...
TRANSCRIPT
![Page 1: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/1.jpg)
Intro to Core(Python!) Involvement
© Dan Buch 2010
~ Licensed Creative Commons Attribution-ShareAlike 3.0 http://creativecommons.org/licenses/by-sa/3.0/
![Page 2: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/2.jpg)
Who I am
What I do
Why this talk?
Who should care?
![Page 3: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/3.jpg)
What is covered here?
~ Python Developer's Guide
~ Bugs
~ Documentation
~ Proselytizing
![Page 4: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/4.jpg)
![Page 5: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/5.jpg)
http://python.org/dev/
The Python Developer's Guide
![Page 6: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/6.jpg)
What the Guide tells you
~ All about code-related stuff
~ Where the bug tracker is located
~ Where to find documentation
http://python.org/dev/
![Page 7: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/7.jpg)
What the Guide fails to tell you
~ How to be nice
~ How to be patient
~ ... not much else, but it may take a while to find it all
http://python.org/dev/
![Page 8: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/8.jpg)
The Guide: code-related stuff~ Where to get source code
~ http://bit.ly/py3k-svn
~ How to test code changes~ http://bit.ly/py-test-patch
~ How to submit changes back~ http://python.org/dev/patches/
~ Where the bug tracker is located~ http://bugs.python.org
~ Other stuff!~ http://python.org/dev/faq/
![Page 9: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/9.jpg)
![Page 10: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/10.jpg)
Bug submission and triage for folks in a hurry
Roundup
http://bugs.python.org/
http://python.org/dev/faq/http://python.org/dev/
![Page 11: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/11.jpg)
Bug submission and triage for folks in a hurry
~ Roundup
~ Openly developed http://roundup.sourceforge.net/
~ Available on the PYPI http://pypi.python.org/pypi/roundup/
~ Web-based (plus extras)~ (mostly) easy to use, but still very much "Web 1.0"~ <insert live miniature demo>
http://bugs.python.org/http://python.org/dev/faq/
http://python.org/dev/
![Page 12: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/12.jpg)
How to work on an issue
~ Check history
~ Update
~ Reproduce
~ Communicate
~ Tread lightly
~ Test, Test, Test, Test, Test
http://bugs.python.org/http://python.org/dev/faq/
http://python.org/dev/
![Page 13: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/13.jpg)
Issue Submission:Anti-Patterns
~ Omit lots of technical bits
~ Insult original developers
~ Ignore prior art
~ Assume somebody else will triage your dupe
~ Ignore future activity of your issue
http://bugs.python.org/http://python.org/dev/faq/
http://python.org/dev/
![Page 14: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/14.jpg)
Issue Submission:Patterns
~ Do your homework
~ Be concise, but thorough~ when in doubt, leave it in
~ Be objective
~ Be nice
http://bugs.python.org/http://python.org/dev/faq/
http://python.org/dev/
... or how to communicate effectively (in writing!) with other human beings
![Page 15: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/15.jpg)
Issue Submission:Patterns
~ Subscribe to the New Bugs mailing list
~ http://bit.ly/py-bugs-list
http://bugs.python.org/http://python.org/dev/faq/
http://python.org/dev/
![Page 16: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/16.jpg)
![Page 17: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/17.jpg)
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
... or boring or worthless
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
Documentation isn't scary
![Page 18: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/18.jpg)
~ Assume you can't help with the docs
~ Assume the current docs are correct
~ Only read the docs about which you care
~ Ignore Strunk & Whitehttp://bit.ly/elem-o-style
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
Helping with Documentation:Anti-Patterns
![Page 19: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/19.jpg)
~ Read, Read, and Re-Read
~ Try it!
~ Recruit "non-tech" folks
~ Learn reStructuredTexthttp://bit.ly/rst-docs
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
Helping with Documentation:Patterns
![Page 20: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/20.jpg)
~ Subscribe to the Doc-SIG mailing list
http://bit.ly/py-doc-sig
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
Helping with Documentation:Patterns
![Page 21: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/21.jpg)
![Page 22: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/22.jpg)
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
There's more to Python thandicts and iterators.
... or how to promote interest in Pythonwithout losing your audience in the process.
(a mini tutorial)
![Page 23: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/23.jpg)
![Page 24: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/24.jpg)
~ Limit circle of friends to CS Majors
~ Insult people
~ Refuse to use other programming languages
~ Make excuses for Python's flaws~ (don't worry... you won't have to do this)
Promoting Python:Anti-Patterns
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
![Page 25: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/25.jpg)
~ Tirelessly promote SIGs to "non-tech" people~ Diversity-SIG http://bit.ly/py-diversity-sig-
list
~ Edu-SIG http://bit.ly/py-edu-sig-list~ I18n-SIG http://bit.ly/py-i18n-sig-list
~ Engage in (productive!) conversation with advocates of other programming languages
~ Be nice
Promoting Python:Patterns
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
![Page 26: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/26.jpg)
Python Quality Assurance
http://bit.ly/py-docs-dev
http://python.org/dev/doc/
http://bugs.python.org/
http://python.org/dev/faq/
http://python.org/dev/
def increase_quality(self, diversity): # TODO: be sure to mention this in the docs self.diversity += diversity self.quality = self.quality ** self.diversity
soapbox time
![Page 27: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/27.jpg)
EOF
![Page 28: Intro to Core (Python!) Involvement © Dan Buch 2010 daniel.buch@gmail.com ~ Licensed Creative Commons Attribution-ShareAlike 3.0](https://reader036.vdocument.in/reader036/viewer/2022062511/551400fe550346e7488b48c6/html5/thumbnails/28.jpg)
http://bit.ly/elem-o-style
http://bit.ly/py3k-svn
http://bit.ly/py-bugs-list
http://bit.ly/py-diversity-sig-list
http://bit.ly/py-docs-dev
http://bit.ly/py-doc-sig
http://bit.ly/py-edu-sig-list
http://bit.ly/py-i18n-sig-list
http://bit.ly/py-test-patch
http://bit.ly/rst-docs
http://bugs.python.org
http://pypi.python.org/pypi/roundup
http://python.org/dev
http://python.org/dev/doc
http://python.org/dev/faq
http://python.org/dev/patches
http://roundup.sourceforge.net
http://creativecommons.org/licenses/by-sa/3.0/