Patch 2

[StudentSuite3]

⏸️ Paper freeze active. Do not modify anything under paper/results-frozen/, results/, the faircode/ analysis core, any audit.yaml / dataset CSV, or the reproducibility parameters (random_state, split, iteration counts, metrics) - these are frozen for a paper in peer review (see CLAUDE.md). New audits cannot merge to main yet (timing hold - they will be parked post-paper). Explainers, docs, website, and tooling are unaffected. If you think you found a bug in the analysis code, flag it in an issue - do not silently fix it.

Summary

Type

• Audit
• Explainer
• Bug fix
• Other

---

Audit checklist

• I opened or linked a corresponding issue first
• The folder is named after the domain, not the dataset
• unfair.py includes protected attributes and prints the required output format
• fair.py removes protected attributes and identified proxy variables
• Both scripts use random_state=42 and an 80/20 train/test split
• Proxy variables were actually tested, not just guessed
• unfair.png and fair.png are included as PNG screenshots
• The dataset is public and accessible without login or payment
• The dataset file is included, or DATA.md is included if the file is too large
• README.md includes the new results row and audit section
• A notebook was added if the audit benefits from one

Before fairness gap:

After fairness gap:

Reduction:

Protected attribute(s):

Proxy variables dropped:

---

Explainer checklist

• The file is in explainers/ and uses lowercase hyphenated naming
• It includes a plain-language definition
• It uses a real example from this repo or a documented real-world case
• It includes runnable Python detection or measurement code
• It acknowledges limitations or trade-offs
• It links to related explainers or repo projects
• It includes 2-3 primary sources
• The Explainers table in README.md was updated

---

Linked issue

Closes #

[github-actions]

Hey @StudentSuite3, your first PR on Fair Code, that's awesome, thank you.

This project is about making AI more accountable, and contributions like yours are what keep that work going. We'll review your changes shortly.

If you haven't already, give the contributing guide a quick read: it covers how audits are structured and what we look for in a review.

[github-actions]

@yakew7 - new PR touching a path you own, please review.