Feedback for “Getting Started With GraphQL.js”

[lars-thurman]

you start page took to 15 minutes to figure out where to place the server.js file. Not really impressed so far, if you cannot explain how you get started in your https://www.graphql-js.org/docs/getting-started/ page does not give proper instructions.

it does not explain the file structure well, and did not know the server.js file needed to go into the node_modules.

To handle GraphQL queries, we need a schema that defines the Query type, and we need an API root with a function called a “resolver” for each API endpoint. For an API that just returns “Hello world!”, we can put this code in a file named server.js:

[lars-thurman]

https://www.graphql-js.org/docs/graphql-clients/

also curl command does not work

C:\graphql\first-express-graphql>curl -X POST -H "Content-Type: application/json" -d '{"query": "{ hello }" }' http://localhost:4000/graphql
curl: (3) URL rejected: Malformed input to a URL function
curl: (3) unmatched close brace/bracket in URL position 1:
}'
^

however this works
curl -X POST -H "Content-Type: application/json" -d "{"query": "{ hello }" }" http://localhost:4000/graphql

[lars-thurman]

Next step just blows up - really not impressed that I have been at this for 1 hour and still getting nothing but errors from you tutorials

in ruru I get this

fetch('/graphql', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Accept: 'application/json',
},
body: JSON.stringify({ query: '{ hello }' }),
})
.then((r) => r.json())
.then((data) => console.log('data returned:', data));

{
"errors": [
{
"message": "Syntax Error: Unexpected Name "fetch".",
"locations": [
{
"line": 1,
"column": 1
}
]
}
]
}

following the express example and clicking on the link http://localhost:4000/graphql,
I get this
{"errors":[{"message":"Missing query"}]}

[lars-thurman]

Well I have now started over 6 times and have the same outcome -
just a waste of my time.

[yaacovCR]

@lars-thurman Thanks for the feedback. I'm keeping this issue open as hopefully it can be the starting point for anyone (human or otherwise?) interested in submitting PRs to fix the issues you have found.