Skip to content

feat(localities): pull spec from upstream Localities OpenAPI#211

Merged
gaelsimon merged 5 commits into
masterfrom
feat/localities-external-spec
Jun 17, 2026
Merged

feat(localities): pull spec from upstream Localities OpenAPI#211
gaelsimon merged 5 commits into
masterfrom
feat/localities-external-spec

Conversation

@gaelsimon

@gaelsimon gaelsimon commented Jun 12, 2026

Copy link
Copy Markdown
Member

Summary

  • Replace the inlined Localities spec with the prod spec at https://api.woosmap.com/localities/openapi.json — Localities is now bundled via bundle_external_specs like transit / datasets / distance.
  • Delete the in-repo Localities parameters, paths, schemas, and their generated docs (dist/documentation/**/*localities*, plus shared schemas that were only used by Localities: AddressComponents, AdministrativeAreaLabel, FormattedAddress, GeoJsonCoords, GeoJsonGeometry, Position).
  • Extend the redocly inject-code-samples decorator to support multiple named response examples per operation (used for /localities/details Address+PostalCode and /localities/geocode forward+reverse), and harden process-tags.js to drop a path-item only when no HTTP operation remains.

Test plan

  • bazel test //... — 21/21 green locally
  • CI green on PR
  • Spot-check rendered docs against dist/merged-woosmap-openapi3.json to confirm Localities tag content matches the prod upstream

Replace the inlined Localities spec with the prod spec served at
https://api.woosmap.com/localities/openapi.json. Localities is now pulled
via bundle_external_specs alongside transit, datasets, distance, etc.,
and the in-repo parameters/paths/schemas plus their generated docs are
removed.
@gaelsimon

Copy link
Copy Markdown
Member Author

/update-dist

@gaelsimon gaelsimon requested a review from cdartnell-wgs June 15, 2026 07:41
@gaelsimon

Copy link
Copy Markdown
Member Author

/update-dist

@gaelsimon

Copy link
Copy Markdown
Member Author

@gaelsimon

Copy link
Copy Markdown
Member Author

⚠️ would need to adapt redirect rules in devdoc due to Operation ID changes in Localities

@gaelsimon gaelsimon merged commit 5903591 into master Jun 17, 2026
@gaelsimon gaelsimon deleted the feat/localities-external-spec branch June 17, 2026 10:25
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.

2 participants