Skip to content

docs(location-timezone): add Compared to alternatives section#5

Merged
ob-aion merged 2 commits into
mainfrom
docs/compared-to-alternatives
May 21, 2026
Merged

docs(location-timezone): add Compared to alternatives section#5
ob-aion merged 2 commits into
mainfrom
docs/compared-to-alternatives

Conversation

@ob-aion
Copy link
Copy Markdown
Collaborator

@ob-aion ob-aion commented May 21, 2026

Summary

  • Adds a ## Compared to alternatives section to the README, mirroring the pattern in @coroboros/clone.
  • Compares @coroboros/location-timezone against i18n-iso-countries, countries-list, geo-tz (different input model — lat/lng polygon, not city name), and city-timezones (closest peer in shape).
  • Table rows are feature-presence only (UN + CIA country forms, ISO 3166 codes, capital coords/tz, US state codes, city coords, city-name → tz lookup, cross-references, deps) — no raw performance numbers, since the alternatives don't share a methodology.
  • Positioning paragraph names the differentiator (consolidation of five domains with cross-references resolved at parse time, behind O(1) Map/Set indexes).
  • TOC entry added between Limitations and Contributing.

Test plan

  • Render the README on github.com — anchor #compared-to-alternatives resolves from the TOC.
  • Table renders with right-aligned status columns in GitHub-flavored markdown.
  • No regressions in existing sections (Data, API, Subpath exports, Limitations).

ob-aion added 2 commits May 21, 2026 16:09
Mirrors the pattern from @coroboros/clone: feature-presence table
plus a positioning paragraph. Compares against `i18n-iso-countries`,
`countries-list`, `geo-tz` (different input model: lat/lng polygon),
and `city-timezones` (closest peer in shape). TOC updated; section
sits between Limitations and Contributing.
'The consolidation is the differentiator' was abstract on both
sides. Replaced with a direct statement that names the consolidation
shape.
@ob-aion ob-aion merged commit e8395ef into main May 21, 2026
5 checks passed
@ob-aion ob-aion deleted the docs/compared-to-alternatives branch May 21, 2026 09:50
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