diff --git a/docs/guides/migrating.md b/docs/guides/migrating.md
index dddf879a43..8cfd803d93 100644
--- a/docs/guides/migrating.md
+++ b/docs/guides/migrating.md
@@ -27,6 +27,14 @@ The new [schemas and resolvers](../api/schema/index.md) cover most use cases pre
 
 ## TypeScript
 
+<LanguageBlock global-id="js">
+
+You have selected JavaScript as the language which does not have type information.
+
+</LanguageBlock>
+
+<LanguageBlock global-id="ts">
+
 The new version comes with major improvements in TypeScript support from improved service typings, fully typed hook context and typed configuration. You can see the changes necessary in the Feathers chat [here](https://github.com/feathersjs/feathers-chat-ts/compare/dove-pre).
 
 ### Application and hook context
@@ -53,6 +61,8 @@ Now `import { HookContext } from './declarations'` can be used as the context in
 
 ### Service types
 
+
+
 Service types now only need the actual service class type and should no longer include the `& ServiceAddons<any>`. E.g. for the messages service like this:
 
 ```ts
@@ -94,6 +104,8 @@ declare module '@feathersjs/feathers/lib/declarations' {
 }
 ```
 
+</LanguageBlock>
+
 ## Deprecations and breaking changes
 
 ### Express middleware order