nadavWeisler / nadavWeisler/MedCodeTranslator
[Data] Close Hebrew terminology gap and honest bilingual UX
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 0
- Forks
- 0
- Avg merge
- 7m
- Merged PRs (30d)
- 7
Description
Problem summary
Marketing and i18n claim a bilingual interface (hero_stat_bilingual), but ICD-10 (~74k records) has zero name_he fields. Selecting Hebrew changes UI chrome but not terminology display names for major schemes.
Affected area
data/vocabularies/icd10.json(noname_he)app/components/CodeCard.tsx(falls back toname_en)i18n/locales/*.jsonassets/data/(contains some Hebrew demo labels not merged into runtime data)
Expected behavior
When Hebrew is selected, users see Hebrew terminology where available, with an honest fallback indicator when only English labels exist.
Actual behavior
Hebrew UI language mostly affects chrome strings. ICD-10 and other full datasets display English names only with no explanation.
Acceptance criteria
- Short term: show "English only for this scheme" chip when
name_heis absent. - Medium term: merge available Hebrew labels from demo assets into runtime vocabularies for high-traffic codes.
- Update marketing copy to "9 UI languages" or qualify bilingual claims until terminology coverage improves.
- Document Hebrew coverage per scheme in
DATA_SOURCES.md.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with app/components/CodeCard.tsx and data/vocabularies/icd10.json to trace the current Hebrew fallback, then compare assets/data/ with the runtime vocabularies and review i18n/locales/*.json. Check DATA_SOURCES.md and the marketing copy before making changes. Done means missing Hebrew coverage is identified in the UI, available labels are merged where specified, claims are qualified, and coverage is documented per scheme.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- content, data, documentation, frontend, internationalization
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100