doc:connection:precise expected return of connection resolver

[antoine-gallix]

connection documentation lacks a lot of details: #887

[ekampf]

Hi @antoine-gallix,
I have a problem with the statement "The resolver of a connection field should return a list" as its usually not True.
graphene has the capability to automatically turn a list into a Connection structure but that's not the common use case.
In fact, I can't really think of a real production use-case for this - loading an entire dataset into memory and only returning a portion of it via Connection.

The common use case for a Connection. is where the resolver return the entire Connection structure...

[antoine-gallix]

I wanted to improve the documentation because it was not clear to me what a resolver function was supposed to return. We managed to make it work by returning a list of objects, as no other way is documented. But as you seems to know better what the standard practice is, could you please explain it in detail so we can improve the documentation together?

[phalt]

@ekampf can you suggest a better doc for this?

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.