Documentation vs Reality

[ricardo-reis-1970]

Dear sirs,

I am learning GraphQL and I elected the 🍓 because I have good taste. The overall consensus is that the product is great, plus it integrates with FastAPI, so I came to stay, for sure.

The only thing is that I have 25+ years of teaching / Knowledge Transfer experience and I am in a position to regrettably state that the docs are not the shiniest side of the 🍓, not by a landslide. The examples I've been encountering fall through all the possible cracks: incomplete, inaccurate, not working, assuming things, etc, etc. And this is me still on Subscriptions.

I have all my examples working, and I would very much like to contribute these, as well as more details on the explanations, but I don't see how. Your Discord channel is completely out of the table. For more than a year (aka, ever since I created an account there), they've been blocking me from logging in, unless I use mobile phone verification, and I am simply not doing that. I literally never logged in to my Discord account, because of that.

X is also not an option, because I wish that Musk gets painful nasty diseases and bankruptcy, not one more user. So this is the only channel I have.

What I'd like to know is who is the person / team responsible for the docs, so that I could interact directly with them and think of a way to move this effort forward. I am really liking the product and I'd like to make part of the solution.

[patrick91]

You can reach out to me 😊