Apollo Urgently Needs Better Docs for Subscriptions

I don’t urgently need this – I already put in 50+ hours to solve it. :slightly_frowning_face: But why did I have to?

Apollo has the fantastic lift-off series which is so well done. It provides awesome docs on Apollo Server and Client setup. But it doesn’t talk about how to setup subscriptions with context.

Why isn’t there documentation for this?

How many new users are being blocked from using Apollo due to this glaring absence of documentation?

</soapbox>

Hi @vikr00001 :wave: so sorry you found the documentation lacking here. Did you happen to notice this Operation context area of Apollo Server’s Subscriptions docs?

I’m wondering what we can do in order to make that info more present - are you suggesting that we add it to the Lift-off series as well? Thanks for sticking with it, eager to hear how we could have made it better in hindsight :pray:

I did see that, and it was helpful. But without a matching Apollo Client setup, it didn’t work.

I’m wondering what we can do in order to make that info more present - are you suggesting that we add it to the Lift-off series as well?

Yes, 100%

Hello,
I can understand your issue after investing over 50 hours into this issue. It’s disappointing that Apollo’s Lift-off series 1, despite its thoroughness, lacks documentation on setting up subscriptions with context. This gap in documentation can indeed be a barrier for new users. It might be helpful to provide feedback directly to Apollo’s support or community forum to highlight this issue and encourage the addition of comprehensive documentation for subscription setup with context.

1 Like