Skip to content

Documentation vs Reality #3846

Open
Open
@ricardo-reis-1970

Description

@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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions