Better documentation

[ollyde]

When I go to https://async-graphql.github.io/async-graphql/en/quickstart.html

I don't get a simple full example of a working server.

Instead I have to go though and try to find pages of docs in the example Github, which also isn't clear.

[ollyde]

For example, here is a basic full setup

main.rs

use actix_web::{guard, web, App, HttpResponse, HttpServer, Result};
use async_graphql::{http::GraphiQLSource, EmptyMutation, EmptySubscription, Schema};
use async_graphql_actix_web::GraphQL;

mod features;

use features::test::test_schema::TestSchema;

async fn index_graphiql() -> Result<HttpResponse> {
    Ok(HttpResponse::Ok()
        .content_type("text/html; charset=utf-8")
        .body(GraphiQLSource::build().endpoint("/").finish()))
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    println!("GraphiQL IDE: http://localhost:8000");

    HttpServer::new(move || {
        let schema = Schema::build(TestSchema, EmptyMutation, EmptySubscription).finish();

        App::new()
            .service(
                web::resource("/")
                    .guard(guard::Post())
                    .to(GraphQL::new(schema)),
            )
            .service(web::resource("/").guard(guard::Get()).to(index_graphiql))
    })
    .bind("127.0.0.1:8000")?
    .run()
    .await
}

test_schema.rs

use async_graphql::{Context, EmptyMutation, EmptySubscription, Object, Schema};

pub struct TestSchema;

#[Object]
impl TestSchema {
    async fn hello(&self, ctx: &Context<'_>) -> String {
        "Hello, world!".to_string()
    }
}

pub type TestSchemaService = Schema<TestSchema, EmptyMutation, EmptySubscription>;

[kingsleyh]

There is also no understandable documentation that explains to make a schema that is not just hardcoded values. Also there is no explanation of what the context is or how to use it.

[Miaxos]

What the context is: https://async-graphql.github.io/async-graphql/en/context.html
Some examples that should help you: https://github.com/async-graphql/examples