I’ve been reading the CHAOSS Metrics (Community Health Analytics Open Source Software) recently. Emmy printed them for me so I could easily annotate them 😍.
Some notes as I think of them:
Good stuff I probably want to use to measure these projects over time.
- Is there a GitHub repo (or other) already? Y/N. If Y:
- CoC for project
- Is there one? (easy to find automatically, manually, other?)
- Is there enforcement info?
- Is there evidence of mentorship?
- programs (GSoC, Outreachy, internships) (Manual assessment required)
- people who help out - e.g. first-timers only, hacktoberfest could be good proxy measures. (auto)
- contributing md
- How old? Is it the oldest repo in the org? Is it even an org, or a user? This may need to be assessed manually on a case-by-case basis
- Commit metrics:
- # of lines
- # of commits
- Review Metrics
- # of PRs
- # accepted / rejected / left open
- Median time from open-to-resolved.
- Issue/ticket based metrics
- # opened
- # reopened (there are caveats about measuring closed and reopened tickets!)
- # closed
- Time to close (?)
- Committer Metrics
- How many orgs do they come from?
- # of committers
- # loc of commits.
- Licence - present, copyleft, permissive?
- Velocity. The metrics had number of commits vs number of PRs/issues as velocity. Is this meaningful? (I don’t see the point).
- Derived from CHAOSS but not directly their metric - also possibly a hard one to measure. Twitter mentions? //todo investigate how hard/easy this is to track.
- CoC for project
Stuff I’m not sure about / maybe dislike / need to think some more
Licence - this is where it gets tricky. The metrics discuss number of files without a licence in them. This seems contrived to me as a metrics of sustainability, BUT it justifies things by pointing out that companies may not want to pick up higher risk projects that don’t have clear safe licencing processes. It also mentions number of licences, because - logically - this adds legal complexity if some files are licenced one way, some the other. (biopython might be an example here).
Testing hard to assess, but I feel like we should at least check for its presence
Elephant Factor I’m not sure I get it. Number of companies that contribute 50% or more of the effort. I should read the paper (Caroline is one of the authors on this!). Update - see my notes on the paper - it’s totally irrelephant! 🐘