I'm the person who created that Gist for sharing it publicly and I do agree that GraphQL makes pagination confusing. Just yesterday I was searching for a link to share with someone and came across that official page which uses Relay-style connections without naming OR even linking to it which I found very weird.

> I realize that this is an internal doc from Shopify, so if their statement "will be taken care of at implementation time" was meant to just hand-wave for an audience of front-end engineers, that is a reasonable thing to say.

Thank you for pointing this out. I did edit the document to remove Shopify specific mentions and sentences like this, but this one is subtle. I'll likely edit it to be a little clearer and even link to the Relay spec.

edit: I've updated that section. Hopefully it's clearer now :)