graphql-subscriptions icon indicating copy to clipboard operation
graphql-subscriptions copied to clipboard

documentation is out-of-date or wrong

Open jrhite opened this issue 6 years ago • 1 comments

The documentation seems to be very out-of-date everywhere I look. Here are some examples:

The GitHub readme at subscriptions-transport-ws makes reference to a functions graphqlExpress() and graphiqlExpress(). These functions don't seem to exist anymore, nor be the proper way to go. From what I can tell the new way to go about this is something like:

const app = express();
const apolloServer = new ApolloServer(...);
apolloServer.applyMiddleware({ app });
...

The docs at graphql-subscriptions also makes references to graphqlExpress() and graphiqlExpress(). Further, these docs link to a tutorial on Medium which also reference graphqlExpress() and graphiqlExpress().

I feel like I'm feeling my way through the dark on this and not sure which docs to trust and they all seem consistently wrong and/or out-of-date.

jrhite avatar Nov 03 '18 09:11 jrhite

I think a lot of those still reference Apollo Server 1. Apollo Server 2 seems to have drastically changed a lot of things: https://www.apollographql.com/docs/apollo-server/migration-two-dot.html

I'm really short on bandwidth, but PRs accepted.

grantwwu avatar Nov 05 '18 21:11 grantwwu