Skip to content

Add Modeling Differences documentation section#840

Draft
PavelMakarchuk wants to merge 2 commits intomainfrom
add-model-diff-docs
Draft

Add Modeling Differences documentation section#840
PavelMakarchuk wants to merge 2 commits intomainfrom
add-model-diff-docs

Conversation

@PavelMakarchuk
Copy link
Copy Markdown
Collaborator

Summary

Adds a new "Modeling Differences" tab to the dashboard Documentation page that explains how PolicyEngine and TAXSIM outputs differ.

Two parts:

Changes

  • New ModelDifferences.jsx component (collapsible cards for conventions, live GitHub issue feed below)
  • New getIssuesByLabel helper in githubApi.js
  • New model-difference label created on the taxsim repo and applied to open divergence issues
  • Wired into DocumentationContent.jsx as a new section tab

Test plan

  • Production build succeeds (bun run build)
  • Dev server renders section correctly at /documentation
  • Dynamic feed pulls labeled issues from GitHub API
  • Review static convention wording for accuracy

🤖 Generated with Claude Code

PavelMakarchuk and others added 2 commits April 17, 2026 16:08
Adds a new tab to the dashboard Documentation page explaining how
PolicyEngine and TAXSIM outputs differ. Two parts:

- Static conventions (stable architectural choices): v22/actc CTC
  split, state EITC bundling (incl. MN/MO/WA working family credits),
  filing-status auto-detection, spouse income splitting, Additional
  Medicare Tax handling, non-refundable credit ordering.
- Dynamic list of open GitHub issues labeled "model-difference",
  so active divergences stay in sync with the issue tracker.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
PolicyEngine assigns one-time state rebates (e.g. GA HB 112, VA HB 1600)
to the tax year whose liability determines the rebate amount, not the
trigger year or payout year. References issues #716 (GA) and #718 (VA).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
policyengine-taxsim Ready Ready Preview, Comment Apr 19, 2026 9:24pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant