Page MenuHomePhabricator

Reader gets pages that use a reference
Closed, DeclinedPublic

Description

"As a Reader, I want to get a list of all pages that use a reference, so that I can understand the context of that reference."

Reverse lookup for references, probably paginated. Again, reference identity isn't fully developed here, but probably "different pages of the same book or article" and "different fragments ('page#section') of the same web page" count as "the same reference".


GET /reference/{id}/pages?(before={before}|after={after})

Get pages that use this reference.

Parameters:

  • id: id of the reference
  • before: only get pages before this page title
  • after: page title, only get pages after this page title

Only one of before or after allowed.

Notable request headers: none

Status codes:

  • 200: OK
  • 404: No such reference
  • 400: invalid before or after parameters, or both

Notable response headers: none

Response body: JSON object, with these properties

  • next: full link to next segment of the list, or null if N/A
  • prev: full link to the previous segment of the list, or null if N/A
  • first: full link to the first segment of the list
  • pages: array of 0-20 page objects from the schema, with (id, title, key) properties

Related Objects

StatusSubtypeAssignedTask
DeclinedNone
DeclinedNone
DeclinedNone

Event Timeline

eprodromou updated the task description. (Show Details)

Adding Platform Engineering as the "Platform Team Workboards (User Stories)" project was archived and as its open tasks should not linger without any active project tag

matmarex subscribed.

Placeholder task from 2020. I don't think this project is happening.