Skip to content

Clarify pagination requirements and recommended page size (#981)#1

Closed
zeulus wants to merge 1 commit into
release-2.1.0from
feature-pagination-page-size
Closed

Clarify pagination requirements and recommended page size (#981)#1
zeulus wants to merge 1 commit into
release-2.1.0from
feature-pagination-page-size

Conversation

@zeulus

@zeulus zeulus commented Jun 2, 2026

Copy link
Copy Markdown
Owner

Draft for OMF issue openmobilityfoundation#981. Moves core pagination details into general-information.md; agency/provider/policy specs link there. Recommends a minimum page[size] of 500 and a default of 1000, leaving the max to each provider/agency. Policy pagination noted as optional.

Add a shared Pagination section to general-information.md documenting the
JSON:API page[number]/page[size] query parameters, the links object, and
recommended page sizes (minimum 500, default 1000; maximum left to the
provider/agency to document). Point the provider, agency, and policy specs
at it and drop the duplicated keys/example from the provider spec. Note that
policy pagination is optional.

Refs openmobilityfoundation#981
@schnuerle

Copy link
Copy Markdown

This looks good, and pointing to the release 2.1 branch is right. Could you make this same PR over at https://github.com/openmobilityfoundation/mobility-data-specification/pulls so I can tag and edit and have people review there as needed?

@zeulus

zeulus commented Jun 2, 2026

Copy link
Copy Markdown
Owner Author

Superseded by the upstream PR: openmobilityfoundation#982. Closing this preview.

@zeulus zeulus closed this Jun 2, 2026
@zeulus

zeulus commented Jun 2, 2026

Copy link
Copy Markdown
Owner Author

Done @schnuerle, opened PR 982. Maintainer edits are enabled, so feel free to tag/edit/route for 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.

2 participants