I’ve sent a lengthy email to my customer service rep. I’ve also created a Github issue on the relevant repo. Maybe this is the best place to share the answer, so here I am on the forum as well.
I’m a bit frustrated so I’d like to apologize in advance if my tone is aggressive. That is not my intention. I do respect the great work that has been done, and continues, on these plugins.
Gatsby-Prismic plugins: what’s going on?: https://prismic.io/blog/gatsby-prismic-plugins
The contradiction is astounding. A blog post is literally saying one thing while the documentation says exactly the opposite.
While I know the intention of the blog post is to provide clarity, I am still confused. Right after the paragraph stating we should be using gatsby-source-prismic, it says the following:
“We’ve already made a fork to the Gatsby-source plugin, so it should be ready to use and more usable than the previous version, but we will continue to improve and maintain it over the coming months.”
I don’t know which one you are referring to. The prismicio github organization has a fork of both plugins, but only gatsby-source-prismic-graphql appears to be actively maintained. However, PR’s and issues have now gone without responses for more than two weeks. Perhaps Marc McIntosh is on vacation? (which is totally fine by the way - I’m a big fan of vacations myself - but it would be great if someone else could provide some update in his absence).
So please…which is it? gatsby-source-prismic-graphql or gatsby-source-prismic?