appwrite · gewenyu99 · Dec 20, 2023 · Dec 20, 2023 · Dec 20, 2023 · Dec 21, 2023
diff --git a/src/partials/auth-security.md b/src/partials/auth-security.md
@@ -12,9 +12,11 @@ Password dictionary can be enabled in the Auth service's **Security** tab on the
 
 # Password hashing  {% #password-hashing %}
 Appwrite protects passwords by using the [Argon2](https://github.com/P-H-C/phc-winner-argon2) password-hashing algorithm.
-Argon 2 is a resilient and secure password hashing algorithm, which is also the winner of the [Password Hashing Competition](https://www.password-hashing.net/)
+Argon 2 is a resilient and secure password hashing algorithm, which is also the winner of the [Password Hashing Competition](https://www.password-hashing.net/).
 Appwrite combines Argon 2 with the use of techniques such as salting, adjustable work factors, and memory hardness to securely handle passwords.
 
+If an user is imported into Appwrite with hash differnt than Argon2, the password will be re-hashed on first successful user's sign in. This ensures all passwords are stored as securely as possible.
+
 # Personal data  {% #personal-data %}
 
 Encourage passwords that are hard to guess by disallowing users to pick passwords that contain personal data.

diff --git a/src/routes/docs/Sidebar.svelte b/src/routes/docs/Sidebar.svelte
@@ -53,12 +53,18 @@
 					icon: 'icon-lightning-bolt',
 					isParent: true
 				},
+				{
+					label: 'Messaging',
+					href: '/docs/products/messaging',
+					icon: 'icon-send',
+					isParent: true
+				},
 				{
 					label: 'Storage',
 					href: '/docs/products/storage',
 					icon: 'icon-folder',
 					isParent: true
-				}
+				},
 			]
 		},
 		{

diff --git a/src/routes/docs/advanced/platform/+page.markdoc b/src/routes/docs/advanced/platform/+page.markdoc
@@ -68,6 +68,6 @@ Configure custom domains and customize communication templates.
 Add a custom domain for your Appwrite APIs.
 {% /cards_item %}
 {% cards_item href="/docs/advanced/platform/message-templates" title="Message templates" %}
-Create custom branding and messages when you communicate with users..
+Create custom branding and messages when you communicate with users.
 {% /cards_item %}
 {% /cards %}
diff --git a/src/routes/docs/apis/graphql/+page.markdoc b/src/routes/docs/apis/graphql/+page.markdoc
@@ -106,8 +106,8 @@ If no errors occur, the array will not be present in the response.
 # Authentication {% #authentication %}
 
 GraphQL authenticates using Appwrite accounts and sessions. 
-Both accounts and sessions can be created with GraphQL using the `accountCreate`, `accountCreateEmailSession`, 
-`accountCreateAnonymousSession`, or `accountCreatePhoneSession` mutations.
+Both accounts and sessions can be created with GraphQL using the `accountCreate`, `accountCreateEmailPasswordSession`, 
+`accountCreateAnonymousSession`, or `accountCreatePhoneToken` mutations.
 
 More information and examples of authenticating users can be found in the dedicated [authentication guide](/docs/products/auth).
 

diff --git a/src/routes/docs/products/auth/+layout.svelte b/src/routes/docs/products/auth/+layout.svelte
@@ -1,101 +1,121 @@
 <script lang="ts">
-	import Docs from '$lib/layouts/Docs.svelte';
-	import Sidebar, { type NavParent, type NavTree } from '$lib/layouts/Sidebar.svelte';
+    import Docs from '$lib/layouts/Docs.svelte';
+    import Sidebar, { type NavParent, type NavTree } from '$lib/layouts/Sidebar.svelte';
 
-	const parent: NavParent = {
-		href: '/docs',
-		label: 'Auth'
-	};
+    const parent: NavParent = {
+        href: '/docs',
+        label: 'Auth'
+    };
 
-	const navigation: NavTree = [
-		{
-			label: 'Getting started',
-			items: [
-				{
-					label: 'Overview',
-					href: '/docs/products/auth'
-				},
-				{
-					label: 'Quick start',
-					href: '/docs/products/auth/quick-start'
-				}
-			]
-		},
-		{
-			label: 'Concepts',
-			items: [
-				{
-					label: 'Accounts',
-					href: '/docs/products/auth/accounts'
-				},
-				{
-					label: 'Users',
-					href: '/docs/products/auth/users'
-				},
-				{
-					label: 'Teams',
-					href: '/docs/products/auth/teams'
-				},
-				{
-					label: 'Labels',
-					href: '/docs/products/auth/labels'
-				},
-				{
-					label: 'Security',
-					href: '/docs/products/auth/security'
-				}
-			]
-		},
-		{
-			label: 'Journeys',
-			items: [
-				{
-					label: 'Email and password login',
-					href: '/docs/products/auth/email-password'
-				},
-				{
-					label: 'Phone (SMS) login',
-					href: '/docs/products/auth/phone-sms'
-				},
-				{
-					label: 'Magic URL login',
-					href: '/docs/products/auth/magic-url'
-				},
-				{
-					label: 'OAuth 2 login',
-					href: '/docs/products/auth/oauth2'
-				},
-				{
-					label: 'Anonymous login',
-					href: '/docs/products/auth/anonymous'
-				},
-				{
-					label: 'JWT login',
-					href: '/docs/products/auth/jwt'
-				},
-			]
-		},
-		{
-			label: 'References',
-			items: [
-				{
-					label: 'Account API',
-					href: '/docs/references/cloud/client-web/account'
-				},
-				{
-					label: 'Users API',
-					href: '/docs/references/cloud/server-nodejs/users'
-				},
-				{
-					label: 'Teams API',
-					href: '/docs/references/cloud/client-web/teams'
-				}
-			]
-		},
-	];
+    const navigation: NavTree = [
+        {
+            label: 'Getting started',
+            items: [
+                {
+                    label: 'Overview',
+                    href: '/docs/products/auth'
+                },
+                {
+                    label: 'Quick start',
+                    href: '/docs/products/auth/quick-start'
+                }
+            ]
+        },
+        {
+            label: 'Concepts',
+            items: [
+                {
+                    label: 'Accounts',
+                    href: '/docs/products/auth/accounts'
+                },
+                {
+                    label: 'Users',
+                    href: '/docs/products/auth/users'
+                },
+                {
+                    label: 'Teams',
+                    href: '/docs/products/auth/teams'
+                },
+                {
+                    label: 'Labels',
+                    href: '/docs/products/auth/labels'
+                },
+                {
+                    label: 'Security',
+                    href: '/docs/products/auth/security'
+                },
+                {
+                    label: 'Tokens',
+                    href: '/docs/products/auth/tokens'
+                }
+            ]
+        },
+        {
+            label: 'Journeys',
+            items: [
+                {
+                    label: 'Email and password login',
+                    href: '/docs/products/auth/email-password'
+                },
+                {
+                    label: 'Phone (SMS) login',
+                    href: '/docs/products/auth/phone-sms'
+                },
+                {
+                    label: 'Magic URL login',
+                    href: '/docs/products/auth/magic-url'
+                },
+                {
+                    label: 'Email OTP login',
+                    href: '/docs/products/auth/email-otp'
+                },
+                {
+                    label: 'OAuth2 login',
+                    href: '/docs/products/auth/oauth2'
+                },
+                {
+                    label: 'Anonymous login',
+                    href: '/docs/products/auth/anonymous'
+                },
+                {
+                    label: 'JWT login',
+                    href: '/docs/products/auth/jwt'
+                },
+                {
+                    label: 'SSR login',
+                    href: '/docs/products/auth/server-side-rendering'
+                },
+                {
+                    label: 'Custom token login',
+                    href: '/docs/products/auth/custom-token'
+                },
+                {
+                    label: 'Multi-factor authentication',
+                    href: '/docs/products/auth/mfa'
+                }
+            ]
+        },
+        {
+            label: 'References',
+            items: [
+                {
+                    label: 'Account API',
+                    href: '/docs/references/cloud/client-web/account'
+                },
+                {
+                    label: 'Users API',
+                    href: '/docs/references/cloud/server-nodejs/users'
+                },
+                {
+                    label: 'Teams API',
+                    href: '/docs/references/cloud/client-web/teams'
+                }
+            ]
+        }
+    ];
 </script>
 
 <Docs variant="two-side-navs">
-	<Sidebar {navigation} {parent} />
-	<slot />
+    <Sidebar {navigation} {parent} />
+    <slot />
 </Docs>
diff --git a/src/routes/docs/products/auth/accounts/+page.markdoc b/src/routes/docs/products/auth/accounts/+page.markdoc
@@ -12,17 +12,19 @@ Each user's account can also have their own preference object, which you can use
 
 # Signup and login {% #signup-login %}
 
-You can signup and login a user with an account create through 
-[email password](/docs/products/auth/email-password),
-[phone (SMS)](/docs/products/auth/phone-sms),
-[Anonymous](/docs/products/auth/anonymous),
-[magic URL](/docs/products/auth/magic-url), and
-[OAuth 2](/docs/products/auth/oauth2)
-authentication.
+You can signup and login a user with an account created through 
+[Email and password](/docs/products/auth/email-password), 
+[OAuth2](/docs/products/auth/oauth2), 
+[Magic URL](/docs/products/auth/magic-url), 
+[Email OTP](/docs/products/auth/email-otp), 
+[Phone (SMS)](/docs/products/auth/phone-sms), 
+and [Anonymous](/docs/products/auth/anonymous) authentications.
+
+You can also use [Custom token](/docs/products/auth/custom-token) to implement your own authentication flow, or integrate with any external provider.
 
 # Preferences {% #preferences %}
 
-You can store user preferences on a user's account using Appwrite's [Update Preferences](/docs/references/cloud/client-web/account#updatePrefs) endpoint. You can store preferences such as theme, notification settings, or preferred language so they can be synced across multiple devices.
+You can store user preferences on a user's account using Appwrite's [Update preferences](/docs/references/cloud/client-web/account#updatePrefs) endpoint. You can store preferences such as theme, notification settings, or preferred language so they can be synced across multiple devices.
 
 Preferences are stored as a key-value JSON object. The maximum allowed size for preferences is 64kB, and an error will be thrown if this limit is exceeded.
 
@@ -108,7 +110,7 @@ mutation {
 ```
 {% /multicode %}
 
-After a user's preferences are updated, they can be retrieved using the [get account preferences](/docs/references/cloud/client-web/account#getPrefs) endpoint.
+After a user's preferences are updated, they can be retrieved using the [Get preferences](/docs/references/cloud/client-web/account#getPrefs) endpoint.
 
 {% multicode %}
 ```js 

diff --git a/src/routes/docs/products/auth/anonymous/+page.markdoc b/src/routes/docs/products/auth/anonymous/+page.markdoc
@@ -10,7 +10,7 @@ Anonymous sessions allow you to implement **guest** users. Guest users let you s
 
 # Create anonymous session {% #createSession %}
 
-Create an anonymous session with [Create Anonymous Session](/docs/references/cloud/client-web/account#createAnonymousSession) route.
+Create an anonymous session with [Create Anonymous Session](/docs/references/cloud/client-web/account#createAnonymousSession) endpoint.
 
 {% multicode %}
 ```js
@@ -78,7 +78,7 @@ mutation {
 
 # Attaching an account {% #attach-account %}
 
-Anonymous users cannot sign back in. If the session expires, they move to another computer, or they clear their browser data, they won't be able to log in again. Remember to prompt the user to create an account to not lose their data.
+Anonymous users cannot sign back in. If the session expires, they move to another computer, or they clear their browser data, they won't be able to log in again. Remember to prompt the user to claim an account to not lose their data.
 
 Create an account with any of these methods to transition from an anonymous session to a user account session.