Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Outdated GraphQL Java tutorial #913

Closed
andimarek opened this issue Feb 26, 2019 · 3 comments

Comments

Projects
None yet
3 participants
@andimarek
Copy link

commented Feb 26, 2019

Hi,

I am one of the maintainer of GraphQL Java.

The GraphQL Java tutorial by @kaqqao is unfortunately outdated and also uses some third party libraries on top of GraphQL Java, without making it clear that it is actually not GraphQL Java itself.
Our experience has shown that this is confusing for beginners.
Our recommend approach can be found here

Please consider adding a warning message which makes it clear that it is outdated and that this is not the recommend getting started approach for GraphQL Java or maybe just remove it all at the moment.

Just to be clear: I think the tutorial was very helpful overall and thanks a lot to @kaqqao for writing the tutorial in the first place while nobody else picked up the task.

The library itself and the ecosystem have evolved and I just wanna make sure that this is reflected somehow.

Thanks a lot,
Andi

@kaqqao

This comment has been minimized.

Copy link
Contributor

commented Feb 26, 2019

The author here. I 100% agree with @andimarek. The ecosystem has evolved to the point that my tutorial is now more confusing than helpful.
I'll work on rewriting it to the current best practices, but for now, please add a warning message or remove the tutorial.

@jonatasbaldin

This comment has been minimized.

Copy link
Collaborator

commented Mar 10, 2019

Hey there, I agree with both.

I opened #923 to add a warning in the tutorial. Can you take a look and see if that's good?

Thanks!

@andimarek

This comment has been minimized.

Copy link
Author

commented Mar 15, 2019

@jonatasbaldin thanks ... looks good.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.