Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

RFC: skill level change graphs #19

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 56 additions & 0 deletions rfcs/2023-11-16_SKILL_LEVEL_CHANGE_GRAPHS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Dei Explorer: Graphing Year-over-year Change in Skill Level By Gender/Racial Background

**Feature Name:** Graphing Year-over-year Change in Skill Level By Gender Identity/Racial Background

**Proposal Date:** 2023-11-16

**Author:** Conan Lai, Bre Porter, Bryan Washington

**Keywords:** skill level, delta, graph, gender identity, racial background

## Summary

We are looking to add two new graphs to the DEI explorer in Stacks to help us better visualize how our skill level breakdowns by race and gender are evolving over time. Hugh has already taken the first step in getting us here by allowing stacks users to select the specific month that they would like to view our DEI data for.

Using the month selected by the user (or the latest snapshot if no selection has been made), we would like to add graphs that visualize the delta between the skill level breakdown for the currently selected month and the skill level breakdown for the currently selected month in the previous year.

## Underlying Logic

As things are setup right now, we already calculate the skill level breakdowns by race and gender for the currently selected snapshot month. To support these new graphs, we would also need to calculate the skill level breakdowns by race and gender for the currently selected month in the previous year. Once this is calculated, we would simply subtract the previous year's count for eack skill level from the current one and then display it in a graph similar to the mockup provided below.

## Example Calculation

Let's break down how this would look for Skill Level by Racial Background for the current month (November, 2023). The data for the current year and previous year is displayed in a table below. Note that racial background names are simplified to not overly complicate the tables.

November 2023

| Racial Background | ML | EML | S | L |
| - | - |- | - | - |
| Hispanic| 0 | 0 | 2 | 0 |
| Black| 1 | 2 | 1 | 0 |
| White| 0 | 4 | 8 | 5 |
| Asian| 1 | 2 | 3 | 0 |

November 2022

| Racial Background | ML | EML | S | L |
| - | - |- | - | - |
| Hispanic| 0 | 0 | 3 | 0 |
| Black| 2 | 2 | 1 | 0 |
| White| 0 | 4 | 7 | 3 |
| Asian| 1 | 1 | 4 | 0 |

To calculate the deltas for display in the new graph we would simply take the value from each cell in the 2023 table and subtract the value from the cell in the 2022 table. The results are displayed below. This delta would then be used to create a graph as shown in the mockup in the next section.

Year-Over-Year Change November 2023
| Racial Background | ML | EML | S | L |
| - | - |- | - | - |
| Hispanic| 0 | 0 | -1 | 0 |
| Black| -1 | 0 | 0 | 0 |
| White| 0 | 0 | +1 | +2 |
| Asian| 0 | +1 | -1 | 0 |

## Mockup

![Change in Skill Level by Racial Background Example](skill_level_by_racial_background_change.png)

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.