From add6bae5717c9a38d73082a43848a6feafdf9df0 Mon Sep 17 00:00:00 2001 From: Jordan Padams Date: Sat, 28 Mar 2026 06:43:51 -0700 Subject: [PATCH] Fix inaccurate Pagination/Sort documentation in general conventions Removes the `start` parameter which does not exist in the PDS Search API, removes the misleading "Sort" reference from the section heading, drops the external Moesif link, and replaces the section with an accurate description and cross-reference to the detailed pagination docs in the Search API guide. Fixes NASA-PDS/registry-api#746 Co-Authored-By: Claude Sonnet 4.6 --- docs/source/general-conventions.rst | 17 +++-------------- 1 file changed, 3 insertions(+), 14 deletions(-) diff --git a/docs/source/general-conventions.rst b/docs/source/general-conventions.rst index a49215b..944212b 100644 --- a/docs/source/general-conventions.rst +++ b/docs/source/general-conventions.rst @@ -159,18 +159,7 @@ However: - The version is mandatory in the resource representations (result of a request) -Pagination/Sort ---------------- +Pagination +---------- -The query parameters for pagination are: - -+-----------+---------------------------------------------------------------+ -| Parameter | Description | -+===========+===============================================================+ -| start | Index of first item returned in the response | -+-----------+---------------------------------------------------------------+ -| limit | Maximum number of item expected in the response | -+-----------+---------------------------------------------------------------+ - -See -`https://www.moesif.com/blog/technical/api-design/REST-API-Design-Filtering-Sorting-and-Pagination/ `_ +The PDS Search API uses cursor-based pagination via ``search-after`` and ``sort`` parameters, along with ``limit`` to control page size. For detailed usage and examples, see :ref:`guides/search/endpoints:Use pagination to get all products matching a request`.