Community Structure by Project

In order to analyze community structure we rely on Onion model. All panels related to community structure are based on the onion study included in grimoirelab-elk project.

Metrics

This panel splits data into projects. Onion model is computed individually for each project.

  • Contributions by Project: this donut chart placed on the top of the panel splits number of contributions by project.
  • Community Structure: on the top right corner we find the evolution of the different onion roles through time, divided by quarters.
  • Contributions: just below, another bar chart shows the evolution of contributions in order to compare both to better understand how groups evolve.
  • Authors: on the left hand side, a table of authors shows the total number of contributions of each one in the selected time frame together with the number of quarters that author has been active in the community.
  • Projects: below bar charts, there is another table showing number of people and contributions by project and role for the selected time frame.

In addition to Kibana filters and search box on top, filtering by Data Source is allowed by using the top left corner widget. Notice the blue filter on top used for showing only Git data. This filter can be modified by using Data Source widget mentioned above.

Use Notes

1. Only one data source filter should be active at the same time

In Kibana/Kibiter, filters are combined by means of AND operators. E.g. if we enable Git and GitHub filters, under the hood we get an ElasticSearch query like:

data_source=git AND data_source=github

Thus, by selecting more than one data source filter at the same time, we won’t get any result, because data come from one data source or another, but not several at the same time.

Data Source widget automatically manages this for you, so you just need to select the desired data source in the drop down list and click on Apply changes. Data is meaningful only if one and only one data source is selected for filtering.

2. Select one and only one project to view meaningful data

In order to have meaningful data, we need to select the project we are interested in from the donut chart on top or from projects table below bar charts. Then, a new filter will appear on top, next to the other ones, and we’ll get the data we need in the panel.

LIMITATION: when no project is selected for filtering bar chart on the top left corner show group sizes —core, regular, casual— aggregated for all projects. That is, if we have project A with 5 people in core group for 2018Q1 and project B with 2 people in core group for 2018Q1, bar chart will show 7 as value for core group, which is not the result of computing onion for both projects together but the sum of their specific results. This is due to the use of pre-computed values by projects. In order to get data for all projects together, see Overall Community Structure panel.


Edit this doc