Opensource.guide: Data vignettes

[bkeepers]

A lot of the content can be backed up or accompanied by data. For example, "Some of the most popular projects today took years to reach high levels of activity". Oh really? This is interesting, tell me more! A visualization of how long projects typically take to gain adoption would be fascinating.

The print editions of Lonely Planet do a pretty good job of this:

I chatted with @arfon, and he's going to look through the current content and come up with some ideas for vignettes to accompany the current content.

• [ ] Add data vignettes to content model with description and any guidelines
• [ ] Brainstorm list of possible vignettes that would add to the content
• [ ] Figure out how these are incorporated into the design (cc @sophshep)

[arfon]

• [ ] Brainstorm list of possible vignettes that would add to the content

@alysonla @nayafia I just sent a calendar invite to chat about these ideas. I've also added some ideas to this Google Doc

[arfon]

Here are some suggestions based on our conversation. We have data ready to go for most of these so depending upon @sophshep's interest in these ideas we can supply either charts or raw data.

What does open source activity look like?

Either:

For every 100 public contributions on GitHub:

• 35 of them are pushes
• 20 of them are new issues
• 30 of them are issue comments
  ...etc.

Or:

Can we repurpose any of the plots in here? https://github.com/blog/2195-the-shape-of-open-source

Taking the pulse of open source or 24 hours of GitHub

e.g. https://cloud.githubusercontent.com/assets/4483/8175098/cfc932bc-13aa-11e5-8008-0db39d147186.png

Your first time

Either graphs or numbers showing:

• First pull request
• First repository
• First commit
• First comment
• ...etc

Choosing a license

Circle graphics showing the licenses people use for their open source projects.

[nayafia]

Hooray! Thanks to both of you for pulling this together! I love the "for every 100 public contributions..." idea in particular.

Your first time
Either graphs or numbers showing:

Could you provide a bit more detail as to what will be shown in these examples?

Finally, something like "# people making their first PR" or "# people starting their first open source project" might be good...I think there were similar stats pulled for Octoverse?

[nayafia]

For @sophshep stylin' purposes, here are few more data bits already in the handbook that could benefit from design:

• A Mozilla survey found that contributors who received code reviews within 48 hours had a much higher rate of return. ("Building Community" - I can't find the exact numbers for the life of me, so if this one is weird, ignore it)
• Nearly half (48.98%) of contributors on popular GitHub projects only made one contribution. ("Sustaining healthy communities")

[arfon]

Could you provide a bit more detail as to what will be shown in these examples?
Your first time

I think there's a few options here. One would be to simply show some numbers representing these stats. Another would be to show the growth in these numbers over time (i.e. bar/line charts) to show the growth of open source activity on GitHub.

Alternatively we could combine it with the idea above this one (_Pulse of GitHub_) and turn this into some kind of area plot showing people making their first open source contribution in the last 24 hours?

[alysonla]

This may/may not fit, however could show active public repos over time & active users over time. gist

@arfon @bkeepers were there some open source success metrics that may also make sense to include? (or are those the first time contributors metrics?)

[arfon]

This may/may not fit, however could show active public repos over time & active users over time. gist

I like seeing these graphs but I'm wondering if this is a little too much _about GitHub_ (and our growth).

@arfon @bkeepers were there some open source success metrics that may also make sense to include? (or are those the first time contributors metrics?). Whaddya think @nayafia?

😍 oh we have that as a KPI for our team. We just don't quite know how to measure that yet 😁

[nayafia]

hehe, good point @arfon, I didn't think about that. How about we just go with this suggestion:

Alternatively we could combine it with the idea above this one (Pulse of GitHub) and turn this into some kind of area plot showing people making their first open source contribution in the last 24 hours?

[nayafia]

Closing, we added some vignettes in https://github.com/github/open-source-guide/pull/148