update wording and fix links.

supertokens · Aug 16, 2024 · 2dd25c6 · 2dd25c6
1 parent f67d134
commit 2dd25c6
Show file tree

Hide file tree

Showing 27 changed files with 468 additions and 461 deletions.
diff --git a/v2/community/sdks.mdx b/v2/community/sdks.mdx
@@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink"
 
 ## SDK Migration
 
-See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs.
+See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs.
 
 :::info
 Visit the [API reference page](./apis) to learn more.

diff --git a/v2/community/updating-supertokens.mdx b/v2/community/updating-supertokens.mdx
@@ -0,0 +1,65 @@
+---
+id: updating-supertokens
+title: Updating Supertokens core and SDKs
+hide_title: true
+---
+
+<!-- COPY DOCS -->
+<!-- ./community/updating-supertokens.mdx -->
+
+# Updating SuperTokens core and SDKs
+
+:::important
+You need to follow these steps in order to properly update supertokens
+:::
+
+In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible.
+
+## 1. Updating your core
+
+You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween
+your starting version and the latest version. You may then bring your core back online.
+
+In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and
+back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them.
+
+- ### Self-hosted core
+See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md).
+
+- ### Managed core
+If you're using the managed core service, please email us at [email protected] from your registered email to request a core update.
+
+## 2. Update your back-end SDK
+
+Follow the steps in the migration sections of the linked changelog from your current version up to the latest version.
+
+- ### NodeJS
+See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md).
+
+- ### GoLang
+See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md).
+
+- ### Python
+See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md).
+
+## 3. Update your front-end SDK
+
+Follow the steps in the migration sections of the linked changelog from your current version up to the latest version.
+
+- ### ReactJS
+See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md).
+
+- ### Vanilla JS
+See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md).
+
+- ### React Native
+See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md).
+
+- ### iOS
+See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md).
+
+- ### Flutter
+See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md).
+
+- ### Android
+See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md).
diff --git a/v2/community/upgrading-supertokens.mdx b/v2/community/upgrading-supertokens.mdx
diff --git a/v2/emailpassword/sdks.mdx b/v2/emailpassword/sdks.mdx
@@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink"
 
 ## SDK Migration
 
-See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs.
+See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs.
 
 :::info
 Visit the [API reference page](./apis) to learn more.

diff --git a/v2/emailpassword/sidebars.js b/v2/emailpassword/sidebars.js
@@ -737,7 +737,7 @@ module.exports = {
         "migration/mfa-migration"
       ],
     },
-    "upgrading-supertokens",
+    "updating-supertokens",
     {
       type: "category",
       label: "References",

diff --git a/v2/emailpassword/updating-supertokens.mdx b/v2/emailpassword/updating-supertokens.mdx
@@ -0,0 +1,65 @@
+---
+id: updating-supertokens
+title: Updating Supertokens core and SDKs
+hide_title: true
+---
+
+<!-- COPY DOCS -->
+<!-- ./community/updating-supertokens.mdx -->
+
+# Updating SuperTokens core and SDKs
+
+:::important
+You need to follow these steps in order to properly update supertokens
+:::
+
+In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible.
+
+## 1. Updating your core
+
+You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween
+your starting version and the latest version. You may then bring your core back online.
+
+In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and
+back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them.
+
+- ### Self-hosted core
+See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md).
+
+- ### Managed core
+If you're using the managed core service, please email us at [email protected] from your registered email to request a core update.
+
+## 2. Update your back-end SDK
+
+Follow the steps in the migration sections of the linked changelog from your current version up to the latest version.
+
+- ### NodeJS
+See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md).
+
+- ### GoLang
+See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md).
+
+- ### Python
+See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md).
+
+## 3. Update your front-end SDK
+
+Follow the steps in the migration sections of the linked changelog from your current version up to the latest version.
+
+- ### ReactJS
+See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md).
+
+- ### Vanilla JS
+See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md).
+
+- ### React Native
+See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md).
+
+- ### iOS
+See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md).
+
+- ### Flutter
+See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md).
+
+- ### Android
+See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md).
diff --git a/v2/emailpassword/upgrading-supertokens.mdx b/v2/emailpassword/upgrading-supertokens.mdx
diff --git a/v2/passwordless/sdks.mdx b/v2/passwordless/sdks.mdx
@@ -62,7 +62,7 @@ import GuidesLink from "/src/components/guidesLink"
 
 ## SDK Migration
 
-See the [upgrading SuperTokens](./upgrading-supertokens) page for steps on how to migrate SDKs.
+See the [updating SuperTokens](./updating-supertokens) page for steps on how to migrate SDKs.
 
 :::info
 Visit the [API reference page](./apis) to learn more.

diff --git a/v2/passwordless/sidebars.js b/v2/passwordless/sidebars.js
@@ -713,7 +713,7 @@ module.exports = {
         "migration/mfa-migration"
       ],
     },
-    "upgrading-supertokens",
+    "updating-supertokens",
     {
       type: "category",
       label: "References",

diff --git a/v2/passwordless/updating-supertokens.mdx b/v2/passwordless/updating-supertokens.mdx
@@ -0,0 +1,65 @@
+---
+id: updating-supertokens
+title: Updating Supertokens core and SDKs
+hide_title: true
+---
+
+<!-- COPY DOCS -->
+<!-- ./community/updating-supertokens.mdx -->
+
+# Updating SuperTokens core and SDKs
+
+:::important
+You need to follow these steps in order to properly update supertokens
+:::
+
+In order to maintain compatibility and keep up on new features, we recommend updating your core and SDKs whenever possible.
+
+## 1. Updating your core
+
+You will need to shut down your core in order to update it. After it's off, run the migration scripts for all versions inbetween
+your starting version and the latest version. You may then bring your core back online.
+
+In the rare occasion that the supertokens core version you have updated to shows as incompatible with your current front-end and
+back-end sdk's in the [compatibility table](./compatibility-table), then refrain from running your back-end and front-end SDKs until after you update them.
+
+- ### Self-hosted core
+See the migration sections in the [supertokens-core changelog](https://github.com/supertokens/supertokens-core/blob/master/CHANGELOG.md).
+
+- ### Managed core
+If you're using the managed core service, please email us at [email protected] from your registered email to request a core update.
+
+## 2. Update your back-end SDK
+
+Follow the steps in the migration sections of the linked changelog from your current version up to the latest version.
+
+- ### NodeJS
+See the migration sections in the [supertokens-node changelog](https://github.com/supertokens/supertokens-node/blob/master/CHANGELOG.md).
+
+- ### GoLang
+See the migration sections in the [supertokens-golang changelog](https://github.com/supertokens/supertokens-golang/blob/master/CHANGELOG.md).
+
+- ### Python
+See the migration sections in the [supertokens-python changelog](https://github.com/supertokens/supertokens-python/blob/master/CHANGELOG.md).
+
+## 3. Update your front-end SDK
+
+Follow the steps in the migration sections of the linked changelog from your current version up to the latest version.
+
+- ### ReactJS
+See the migration sections in the [supertokens-auth-react changelog](https://github.com/supertokens/supertokens-auth-react/blob/master/CHANGELOG.md).
+
+- ### Vanilla JS
+See the migration sections in the [supertokens-web-js changelog](https://github.com/supertokens/supertokens-web-js/blob/master/CHANGELOG.md).
+
+- ### React Native
+See the migration sections in the [supertokens-react-native changelog](https://github.com/supertokens/supertokens-react-native/blob/master/CHANGELOG.md).
+
+- ### iOS
+See the migration sections in the [supertokens-ios changelog](https://github.com/supertokens/supertokens-ios/blob/master/CHANGELOG.md).
+
+- ### Flutter
+See the migration sections in the [supertokens-flutter changelog](https://github.com/supertokens/supertokens-flutter/blob/master/CHANGELOG.md).
+
+- ### Android
+See the migration sections in the [supertokens-android changelog](https://github.com/supertokens/supertokens-android/blob/master/CHANGELOG.md).