10
edits
Drumbeat/p2pu/courses/readingcode: Difference between revisions
Jump to navigation
Jump to search
no edit summary
(Created page with '== Course Description == In the Open Web world, we are often working with other peoples' code. This code might be a small standalone Python module or Ruby gem, or it might be a …') |
No edit summary |
||
| Line 5: | Line 5: | ||
The Reading Code course will remind us that there is no magic-- only logic. We will dive into the mini universes of open source projects and learn techniques for getting oriented, debugging, and simply getting comfortable reading code. | The Reading Code course will remind us that there is no magic-- only logic. We will dive into the mini universes of open source projects and learn techniques for getting oriented, debugging, and simply getting comfortable reading code. | ||
== Can you lead this course in September == | == Who are You and Can you lead this course in September == | ||
[http://jessykate.com| Jessy Cowan-Sharp]. I can lead this course this September. | |||
== Major Project == | == Major Project == | ||
The major project for the course will involve writing a series of documentation pieces to either add to, extend or improve documentation for the various projects we cover in the course. | The major project for the course will involve writing a series of documentation pieces to either add to, extend or improve documentation for the various projects we cover in the course. | ||
We may decide to collaboratively write documentation for some of the smaller projects, and/or have people document different sections for the bigger projects. | |||
== Format and Structure == | == Format and Structure == | ||
Each week | Each week we will plan to cover one open source project. During the week, participants will read the code sections on their own, and there will be an ongoing chat room, (possibly with people signing up to be present during specific hours) to support discussions and questions. | ||
We will try to cover a variety of project types and languages,and for each project and/or language, specific tools for reading, debugging or understanding the "stack" will be introduced | |||
During the weekly in-virtual-person meetings, a different person will lead each session and together we will go over the section of code assigned for that week, discussing our understanding of what is happening, techniques employed, and areas we found difficult to understand. At the end of the in-virtual-person session, the next week's subject matter will be introduced. | |||
Proposed Projects (balancing languages, familiar/popular frameworks, newness (older and cruftier or well developed vs new code)... | |||
* drupal (php) | |||
* django (or tornado) (python) | |||
* jquery/protovis/raphael (javascript/javascript viz) | |||
* nodejs (javascript) | |||
* mongodb? (c++) or one of the mongodb language drivers (ruby/python) | |||
* Rails | |||
* Erlang? Haskel? | |||
Would like some smaller projects that leverage ec2/s3 | |||
* [https://addons.mozilla.org/en-US/firefox/addon/6955/| firefox s3:// extension] | |||
== What you Should Know == | == What you Should Know == | ||
* Basic programming constructs (for, while, if statements, etc.) | |||
* Additional experience with math and/or logic wil surely be helpful. | |||
== What you can Expect to Learn == | == What you can Expect to Learn == | ||
* Reading comprehension | * Code Reading comprehension | ||
* Exposure to different languages | * Exposure to different languages | ||
* Ability to orient and understand what is happening in the middle of a big project | |||
* Debugging tools for different environments and languages | * Debugging tools for different environments and languages | ||
| Line 36: | Line 56: | ||
* Writing code | * Writing code | ||
* We won't cover Installation and configuration of these tools, although it will probably be helpful to have them installed (to tweak/explore/break them!), and there will be indirect/informal support via the chat room for doing this. | |||
== What Will I build? == | == What Will I build? == | ||
| Line 43: | Line 64: | ||
== Courseware == | == Courseware == | ||
* | * No courseware other than the code we read | ||