Update the SmallRye GraphQL Extension documentation

[phillip-kruger]

Fix #17827

Showing some large Film and Hero DTOs using lots of “dumb” accessors, when replacing them with public fields would work just as well and make the docs shorter and easier to read.

I have changed this to rather use Objects with public fields with a note that Objects with private fields and public getters/setter will also work

Showing @name("filmId") when it's actually optional and we could use the parameter name, inducing me to falsly believe this was required.

In the example the parameter name and the value in the @Name annotation is actually different, so I added a note on that. I also removed the @Name annotations on other examples

I'm told I need to use @Inject Context by https://quarkus.io/guides/smallrye-graphql#context when trying to add it as a query method parameter appeared to Just Work.

@Inject is still useful when using it downstream, i.e in another class, so I added a note on method injection when used within the @GraphQLApi class

Signed-off-by:Phillip Kruger phillip.kruger@gmail.com

[gsmet]

I suggested a few improvements.

[phillip-kruger]

Thanks @gsmet !

[FroMage]

Thanks!