Repository navigation
Report a Rule Problem
Use this page when a rule value, an income limit, or a result in OpenBridge looks wrong. It walks you through the "Eligibility rule correction" form on GitHub, field by field. You do not need to write code. Reports like this are among the most valuable help the project gets.
Use a made-up household in your report, never a real one. Do not include real names, incomes, or immigration status.
- A free GitHub account (see Ways to help), or use email instead.
- Where you saw the problem: a result card, the Show the math table on a program's details
page, or a file such as
data/states/oh/adapter.json. - An official source that shows the correct value.
- On the OpenBridge GitHub page, choose Issues, then New issue.
- Choose Eligibility rule correction.
- Fill in the fields below, then submit the issue.
| Field | What to write |
|---|---|
| Program (required) | Pick one: SNAP, Medicaid, CHIP, WIC, LIHEAP, TANF, Federal poverty guidelines, or Other. |
| State (required) | The two-letter code, for example OH. |
| What looks wrong? (required) | A number, a result for a household, a missing rule, or a source link or date. |
| What OpenBridge says or uses now (required) | The value or result, and where you saw it, for example "SNAP gross income limit shows 130% on the Show the math table". |
| What it should be (required) | The correct value or result, and a sentence on why. |
| A made-up household that shows the problem | Needed when a result is wrong: state, ages, monthly income, other answers, what OpenBridge said, and what you expected. |
| Official source (URL) (required) | A link to an agency page, policy manual, or published table. |
| Where in the source? | A table, page, or section number, so a reviewer can find the number fast. |
| Source publication or effective date (required) | When the source was published or when the value took effect. |
| OpenBridge version or rules data version | If you know it. The toolkit shows it at the bottom of every page. |
| Proposal or test case file | Optional. Drag in a file from the community rule toolkit or the test-case recorder. |
| Your background (optional) | For example navigator or caseworker, agency staff, legal aid, or policy researcher. |
| Privacy check (required) | Check the box to confirm the household is made up. |
One problem per report makes each one easier to check and fix.
- Official. It comes from the agency that sets the rule: HHS for poverty guidelines, USDA FNS for SNAP and WIC, Medicaid.gov or the state Medicaid agency, or the state agency that runs the program.
- Specific. It links to the page, manual section, or table with the number, not just the agency's home page. Add a page or section number if the document is long.
- Current and dated. It shows when it was published or when it takes effect.
- Public. Anyone can open it without a login.
News stories, blog posts, and AI chatbot answers are not official sources. They can help you find one, though.
- A maintainer reads your report and checks the source.
- If the value needs to change, a contributor updates the state's rule file, cites your source, and adds or updates a test case that shows the right result.
- A subject-matter expert reviews the change. The state stays
draftuntil an expert signs off on the whole state (see Review rules as an expert). - You can follow each step on your issue.
OpenBridge never guesses rule numbers. If no source can be found, the value is left as it is and the gap is noted.
Email openbridge@starlingtek.com with the same details: program, state, what OpenBridge shows, what it should be, and your source. We will open the issue for you.
OpenBridge is a prototype. Its rules are drafts that experts have not verified yet, and results are
estimates, not decisions. It is not legal advice. Need help applying for benefits? Call 211 or visit
211.org. This wiki is edited in the wiki/ folder of the repository.
Questions: openbridge@starlingtek.com.
Start here
Use OpenBridge
- Using OpenBridge
- Understanding your results
- Guide for navigators
- Privacy and your data
- Run it on your computer
- Host it for others
- Use it with an AI assistant
Help without code
- Ways to help
- Review rules as an expert
- Record a test case
- Report a rule problem
- Translate OpenBridge
- Test accessibility
- Community rule toolkit
Rules and policy (with code)
- How the rules engine works
- State adapters
- Add or change a rule
- Add a new state
- Golden test cases
- Yearly data updates
Developers