Stream: implementers
Topic: pagination vs includes
René Spronk (Dec 19 2020 at 08:38):
I received the question "if the query statement has _includes, should each page contain them, just the first page, just the last page?"
I'd have to check if the documentation contains specific guidance on this. In general, if the page size is N, then there shall be N 'focal resources of the search' in that page. It's a best practice to _(rev)include other resource types that reference the N 'focal' resources that are part of that same page.
It would kind of defeat the entire purpose of pagination if one would add all includes to the final page. Remember that search is stateless.
This does beg the question of whether one could then have duplicates: some included resource X in page 1, and the same included resource X on page 2. AFAIK that's ok.
Is it?
Lloyd McKenzie (Dec 19 2020 at 14:49):
Every page contains the includes for that page - even if you've seen them on previous pages.
Last updated: Apr 12 2022 at 19:14 UTC
