9 Examining Real Projects
For today’s class we will put the concepts we have been learning into action by examining real world open source software projects.
We will find the online presences of three projects (both general websites and source code repository pages on github), and seek to find out what we can about these aspects of each project.
It may help to have in mind these scenarios:
- We are engineers trying to decide whether to select this project as the basis for a new product we are considering building.
- We are interested in hiring participants from these projects and want to know how mature their open source software experience is.
- The artifact (what they build)
- Licence (or licenses), and any discussion/commentary on it.
- Motivations or incentives for participation (can we figure out why people are here?)
- Contribution process (how do people contribute?)
- Release process (On what schedule? How do they decide?)
- Coordination evidence (e.g., work breakdowns, planning documents)
- Work episodes: identify one closed PR and one open PR that give insight/show examples of processes discussed in the course. Note that you can sort the Issues by “Total Comments” which might help surface interesting Issues.
- Curiosities: what aspects of the GitHub site, project, or community are you curious about?
9.1 Projects to examine
Each of us will examine three projects. We will all examine the YT project https://github.com/yt-project/yt
Then you can pick one from this list:
- https://github.com/kubernetes/kubernetes
- https://github.com/sindresorhus/awesome
- https://github.com/tidyverse/ggplot2
- https://github.com/nocodb/nocodb
- https://github.com/mastodon/mastodon
Finally, you should identify and examine a third project of your own interest. Pick something that you might use, perhaps something from your data science work, or search for a tool in your area of interest.
9.2 Group notes on examination
Form a group of 2 or 3. You will be editing a shared Google Doc. Add your name at the top of the doc. Copy the items to examine from above into the doc (you will have to copy this for each of the three projects that you examine).
You should write a paragraph or two on each bullet point, for each project.
Manage your time effectively to finish this in-class.