React-apollo: 鈦夛笍 Master branch should not have been updated to 2.0.0 when documentation is so outdated.

Created on 30 Oct 2017  路  7Comments  路  Source: apollographql/react-apollo

It doesn't make any sense to move the master branch (and npm) to version 2.0.0 when the usage README and the usage on NPM has not caught up with documentation.

2.0.0 should have been kept as a release candidate until the documentation (at least the very basic usage) has been added.

Feel free to let me know if I'm the only one that feels this.

Most helpful comment

That branch was left open to it could be merged on stage at GraphQL Summit. All branches are cleaned up and I'm fixing doc links today 馃憤

All 7 comments

I have the same feeling, but I think it's because 2.0 is not ready yet? I'm having issues with my mutations and react-apollo not working like before, but I can't find out what i need to change.

@shahzeb1 @albinekb the docs are updated. You're just looking at the old ones. https://www.apollographql.com/docs/react/index.html

and the migration guide here: https://www.apollographql.com/docs/react/2.0-migration.html

One thing I'm missing in the migration guide is how to reset the store, in 1.x that was client.resetStore() but there's no mention how to do it in 2.x with the new separate inMemoryCache. Should I open a new issue for this?

@albinekb - resetStore looks like it's still a function in 2.0

https://www.apollographql.com/docs/react/reference/index.html#ApolloClientmd5-27503515acf6511e4ef21a1f5818cfbaresetStore

I'm currently using 2.0 + client.resetStore() and it's working as expected.

Oh, then I must have struck some other issue 馃檪 I'm having a hard time knowing what versions of all the new libs that I need, some are still 1.x? Some guides mention 2.x, some latest tag and another one mentions the next tag, and some libs are still on 1.x... And I'm having a hard time finding the correct docs for all of these different libs and versions.

@albinekb - fwiw I followed the new setup guide for an app that doesn't currently use Apollo. I installed apollo-client-preset along with the other libs mentioned and everything seems to be working fine. :)

https://www.apollographql.com/docs/react/basics/setup.html

I think if you stick with the above link and the links in the sidebar you should be ok.

That branch was left open to it could be merged on stage at GraphQL Summit. All branches are cleaned up and I'm fixing doc links today 馃憤

Was this page helpful?
0 / 5 - 0 ratings