Apollo-client: docs: 'props' option to queries not documented

[glasser]

I don't see explicit documentation of props in https://www.apollographql.com/docs/react/basics/queries.html

[glasser]

Oh I see it's in https://www.apollographql.com/docs/react/basics/queries.html#graphql-props-option but not in the API section. Still confusing.

[glasser]

(Specifically, I got confused that the props callback has ownProps but other things like options or skip just get the props directly.)

[stale[bot]]

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 to Apollo Client!

[glasser]

I think this is still not done. I also think the name option is not documented in the API section? It's also a little confusing that the API section documents the output from the API (the stuff on data) before the input to the API (options etc).

Honestly in general I find the API section confusing, especially around the fact that there is an option called options. Might be good to be super clear somewhere that options are the options for AC?

[jthegedus]

@glasser It's being tracked in a milestone for the docs so this should get updated in due time.

Now my 2c:
I think the docs need to be more clear that the props of the HOC get passed to through to the Component. For those who are missing HOC knowledge, it's not immediately clear that this happens. It would be great if the docs explored more than one example of utilising options, with a more comprehensive example (multiple props, using some props in the computed option and the rest in the component, etc)