yakew7 / yakew7/Fair-Code

Benefits Denial/fair.py's National-Origin proxy comment says "4.8%" where the real, printed gap is 4.40%

Open Beginner friendly
#679 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
HTML
Stars
47
Forks
45
Avg merge
1h 57m
Merged PRs (30d)
95

Description

Where: Benefits Denial/fair.py, the proxy-removal commentary block:

native.country → protected (national origin). Foreign-born
                 applicants are flagged ineligible at 4.8%
                 lower rates in the biased model - not
                 because of economic differences, but because
                 the country variable encodes labour market
                 discrimination into the prediction.

The gap: the real, printed gap from running the biased model is 4.40%, not 4.8%. Every other place this number appears in the repo agrees on 4.40%:

$ python3 "Benefits Denial/unfair.py" | grep -i origin
── Ineligibility Flag Rate by National Origin ───────────
  US-born            : 20.20% flagged ineligible
  Foreign-born       : 15.81% flagged ineligible
  Fairness Gap (Origin): 4.40%

$ grep -n "4.40\|4.8" "Benefits Denial/README.md" README.md
Benefits Denial/README.md:31:| Origin | 4.40% | 0.52% | 88% |
README.md:78:| ... | Origin: 4.40% → 0.52% | **88%** |
README.md:584:| **Fairness Gap (Origin)** | **4.40%** |
README.md:614:| Origin | 4.40% | 0.52% | **88%** |

Only fair.py's own inline comment is wrong, hardcoded at 4.8%.

Fix direction: change "4.8%" to "4.40%" (or "4.4 percentage points") in Benefits Denial/fair.py's comment block.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open Benefits Denial/fair.py and locate the proxy-removal commentary block mentioning the national-origin gap. Change the incorrect 4.8% figure to 4.40% or 4.4 percentage points, then verify the comment matches the printed result and the other repository references.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
95/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.