Skip to content

Commit 12043f7

Browse files
authored
docs: some migration tweaks (#7148)
- Change description of future to the present - Update sample Lambda code to include `start` as recommended - Replace some references to `integration-collaborators` issues with the integration index page now that more exist
1 parent 5c82475 commit 12043f7

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

docs/source/migration.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ The new `@apollo/server` package contains:
3737

3838
There are no integration-specific subclasses in Apollo Server 4. Instead, there's a single `ApolloServer` class with a single API that all integrations use.
3939

40-
In Apollo Server 3, the Apollo Server core team was responsible for maintaining every integration package. With Apollo Server 4, the AS core team will stop directly maintaining most integration packages. Instead, we will work with the broader open source community [to maintain Apollo Server integrations](https://github.com/apollographql/apollo-server/labels/integration-collaborators), enabling those who regularly use different web frameworks to make the best choices for their framework's integration.
40+
In Apollo Server 3, the Apollo Server core team was responsible for maintaining every integration package. With Apollo Server 4, the AS core team no longer directly maintains most integration packages. Instead, we work with the broader open source community [to maintain Apollo Server integrations](./integrations/integration-index/), enabling those who regularly use different web frameworks to make the best choices for their framework's integration.
4141

4242
For those migrating from Apollo Server 3 to Apollo Server 4, use the below flowchart to see your migration path:
4343

@@ -270,9 +270,7 @@ console.log(`🚀 Server ready at http://localhost:4000/graphql`);
270270

271271
### Removed integrations
272272

273-
The Apollo Server core team no longer maintains the following integration packages in Apollo Server 4. We are [looking for collaborators](https://github.com/apollographql/apollo-server/labels/integration-collaborators) who actively use these frameworks to maintain Apollo Server 4 compatible integration packages.
274-
275-
Apollo Server 4 removes the below integration packages:
273+
The Apollo Server core team no longer maintains the following integration packages in Apollo Server 4:
276274
* [`apollo-server-fastify`](https://www.npmjs.com/package/apollo-server-fastify)
277275
* [`apollo-server-hapi`](https://www.npmjs.com/package/apollo-server-hapi)
278276
* [`apollo-server-koa`](https://www.npmjs.com/package/apollo-server-koa)
@@ -282,6 +280,8 @@ Apollo Server 4 removes the below integration packages:
282280
* [`apollo-server-cloudflare`](https://www.npmjs.com/package/apollo-server-cloudflare)
283281
* [`apollo-server-azure-functions`](https://www.npmjs.com/package/apollo-server-azure-functions)
284282

283+
If you use one of these packages, see [the community integration index](./integrations/integration-index/) to see if an integration exists for your environment yet, or [build your own](./integrations/building-integrations).
284+
285285
In Apollo Server 3, the `apollo-server-express` package supported both Express and its older predecessor [Connect](https://github.com/senchalabs/connect). In Apollo Server 4, `expressMiddleware` no longer supports Connect. An interested developer could [build a Connect-specific middleware](./integrations/building-integrations), and a PR to this migration guide is welcome if someone does this!
286286

287287
### Packages merged into `@apollo/server`
@@ -1087,10 +1087,10 @@ const server = new ApolloServer({
10871087
resolvers,
10881088
});
10891089

1090-
exports.handler = lambdaHandler(server);
1090+
exports.handler = startServerAndCreateLambdaHandler(server);
10911091
```
10921092

1093-
In the above example, the `lambdaHandler` serverless integration function should call the
1093+
In the above example, the `startServerAndCreateLambdaHandler` serverless integration function should call the
10941094
`server.startInBackgroundHandlingStartupErrorsByLoggingAndFailingAllRequests()`
10951095
method.
10961096

0 commit comments

Comments
 (0)