Suddenly the commentary appears in the schema but not properly formatted:

This is how I added the comment:

Exactly, the comment from your PHP code queries/fields is propagated to the schema.
I probably need to document this properly.

When you say "not properly formatted", you are referring to the "new line" in front of the comment, right?

(also, congrats on your first issue on Github! 🎉 ) 😄

Thanks 😄

Yeah I didn't find any hint on where to comment to get it to the schema.
And yes by "not properly formatted" I mean the new line but also the multiple quotation marks in front and behind the comment :)

A really nice feature to have would also be to be able to document the parameters for a function, as by now the PHPDoc gets ignored for paramters and is not parsed into the schema. Or is there already a way to do it and we're doing it wrong?

Indeed, pretty good idea!
I'll keep the issue open until we implement it.

Duplicate of #289