Skip to main content

Interview with tutorial presenter Brandon Rhodes

Last year was a busy one for PyCon tutorial and talk presenter Brandon Rhodes. His conference trips took him from Santa Clara to his home state of Ohio and up to Toronto, with talks at all of them. PyCon was particularly busy with two tutorials as well as two talks, going with single talks at PyOhio and PyCon Canada later in the year. He also made a busy 2011 for himself with three talks at PyOhio in 2011 after his PyCon tutorial, and gave great dictionary talk the year before at PyCon 2010 with the tutorial that started it all. Save for the tutorials, you can check out those presentations on pyvideo.

He’s kicking 2013 off right with a redux of his well received “Documenting Your Project in Sphinx” tutorial, giving its fourth run on Thursday March 14 at 9 AM. Started at PyCon 2010 in Atlanta, the tutorial introduces the widely used Sphinx documentation framework, a staple of the Python community. Sphinx lets you focus on writing great documentation rather than inundating the writer with all sorts of presentation details. The powerful framework is hard at work powering Python’s own documentation at http://docs.python.org/.

Brandon uses a presentation style he dubs “lightning lectures”, where he gives a small lecture on a particular topic, then immediately gets the attendee into an example. New for this year is a streamlining of the exercises, where instead of having attendees make up documentation on the fly, they’re provided with pre-written text, allowing them to focus their efforts on the Sphinx features they just learned.

Two new topics were added for the 2013 edition, both of which are worth the price of admission for anyone getting started towards better documentation. Brandon will be working in some examples of theming to style up your documentation, and deployment to the popular Read The Docs Sphinx hosting service gets some well deserved coverage.

I asked Brandon about the popularity of RTD and its addition to this year’s course, and he was ecstatic to be introducing it. “I think that hosting is only half of the reason for its popularity: the other reason is how simply it integrates into a project's version control system, where commits on GitHub can automatically cause the documentation to be rebuilt on Read The Docs!”

“The tutorial really tries to describe how documentation in text files under version control can integrate with a live project,” he said to describe the course. Organization is key when it comes to documentation, and he covers Sphinx’s layout “in a way that makes sense to people using the library for the first time, as well as for people who are quite experienced with the software but need to look something up.”

He’s also taking the stage for a talk on Friday morning at 10:50, titled “The Naming of Ducks: Where Dynamic Types Meet Smart Conventions”. “I sometimes see snide comments from static language folks about how Python code is unreadable because you never know the types of any of your variables,” he said of how the topic came up. Through this talk he hopes to dispel the unreadability myth by showing the conventions Python programmers use and how they affect the utility of a name. “Variable names in Python are not throw-away; they are our lifeline, that make it possible to read each other's code, and to read our own code months later,” he exclaimed.

Be sure to check out Brandon’s talk on Friday and sign up for his Sphinx tutorial on Thursday at https://us.pycon.org/2013/registration/. Although the conference is sold out, tutorials are still accepting registrations for the low price of $150 per session. That gets you three hours of learning from some of the best educators in the Python world, and includes lunch and a snack break. It’s really worth it, so check out the schedule: https://us.pycon.org/2013/schedule/tutorials/.

Check out what Brandon’s up to on twitter at @brandon_rhodes and take a look at his recent open source project, Skyfield, a really cool astronomy tool. PyCon is happy to have him back again for another year and we hope you enjoy his presentations as well as all of the others on our schedule.

Comments

Popular posts from this blog

PyCon 2018 Code of Conduct Transparency Report

The PyCon Code of Conduct sets standards for how our community interacts with others during the conference. For 2018 the Code of Conduct underwent an extensive overhaul, our procedures for reporting and responding to incidents were improved, and our on-site methods were improved. You can read more about the updates for 2018 here. Cumulatively these changes were meant to improve the safety, welcoming nature, and overall inclusivity of PyCon. Based on initial responses, feedback, and incidents reported this year we feel that we made progress on those goals. A Code of Conduct without appropriate reporting and response procedures is difficult to enforce transparently, and furthermore a lack of transparency in the outcomes of Code of Conduct incidents leaves the community without knowledge of how or if the organizers worked to resolve incidents. With that in mind, we have prepared the following to help the community understand what kind of incidents we received reports about and how the PyCon…

PyCon 2018 Registration is Now Open!

We’re thrilled to announce the opening of registration for PyCon 2018 in Cleveland, Ohio! The prior six PyCons have sold out, so prepare for another one and get your tickets early. The first 800 tickets sold are priced at an early bird discount, saving over 20% on corporate tickets and over 12% on individual tickets. Students save $25 if they purchase early!

To get started, create an account and head to https://us.pycon.org/2018/registration/ to get your tickets!

You get a package that is hard to beat when you register for PyCon. The conference itself is three days worth of our community’s 95 best talks, amazing keynote speakers each morning, and our famed lightning talks to close out each day, but it’s much more than that. It’s having over 3,000 people in one place to learn from and share with. It’s joining a conversation in the hallway with the creators of open source projects. It’s taking yourself from beginner to intermediate, or intermediate to advanced. For some, it’s getting st…

How to get ready for the PyCon development sprints

[A guest post by Kushal Das, one of the 2016 Sprint Coordinators]So — you have already decided to join in the PyCon development sprints! The sprints run for four days, from Thursday to Sunday after the conference. You do not have to be registered for the conference to attend the sprints! Some teams plan to write code over all four days, while some projects plan a shorter sprint if the organizers cannot stay for all four days.Can you start getting prepared for the sprint ahead of time? Yes!There are several things you can do ahead of time, that can save effort once you arrive at the sprints — and some preparations can even be made at home, before you arrive at PyCon:Have your operating system updated and patched — whether Mac, Windows, or Linux. This eliminates one possible source of problems with getting software up and running.Go ahead and install the version control system that will be used by the projects you are interested in. If you install both git and Mercurial on your computer…